nn::ac::CTR::ConnectAsync Function

Result ConnectAsync(
     Config & config,
     os::Event * event
);

	Name	Description
in	config	Instance of connection conditions.
in	event	An initialized nn::os::Event that indicates the completion of the operation.

The result.

Value	Description
Result::IsSuccess	Completed without error.
nn::fs::ResultNotInitialized	The FS library has not been initialized.
ResultInvalidData	Either NULL was specified as an argument or an uninitialized Event was specified.
ResultAlreadyExists	Already processing.
ResultCanceled	Canceled while a connection was being processed.
ResultNotAgreeEula	The EULA has not been agreed to, or the icon file has not been configured.
A value other than the above.	Failed for reasons other than those given above.

Starts an asynchronous automatic connection.

Whether the process succeeds or fails, the nn::os::Event specified in the argument is signaled when processing completes.
This API may return success immediately when a connection is completed using BG communications.
If a connection was not established using BG communications, some time may be required for the connection.
We recommend using nn::ndm::SuspendScheduler to stop BG communications and verify operations as needed.

A process runs inside this function to verify that a connection to the Internet is possible.
For this reason, when connecting to an access point that cannot connect to the Internet, extra time is required for verification.

Use this only after you have called the nn::fs::Initialize function.

Once a connection is established, the nn::os::Event registered by RegisterDisconnectEvent is signaled if the system is accidentally disconnected from the access point.
This function gets the application's EULA version, so it returns ResultNotAgreeEula if the icon file is not configured.

2010/11/18

Explained that this function gets the application's EULA information.

2010/06/14

Initial version.