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 as an argument is signaled when processing completes.
This API may return success immediately when a connection is completed using background communications.
If a connection was not established using background communications, some time may be required for the connection.
We recommend using nn::ndm::SuspendScheduler to stop background 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 the RegisterDisconnectEvent function) 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.

When called while using UDS communication, this function returns nn::ndm::ResultExclusiveByOwnProcess.
When using UDS communication, you must call the nn::uds::CTR::Finalize function to finalize communication, before calling this function.

2010/11/18

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

2010/06/14

Initial version.