Cafe SDK  Version 2.13
API References for nn Library Modules
 All Data Structures Namespaces Functions Variables Typedefs Enumerations Enumerator Groups Pages
Modules | Namespaces
Automatic Connection (AC) Library

This module controls automatic network connections. More...

Modules

 Automatic Connection (AC) API (C)
 This is a list of Automatic Connection (AC) library C members.
 
 Automatic Connection (AC) API (C++)
 This is a list of Automatic Connection (AC) library C++ members.
 
 Automatic Connection (AC) API for Devonly (C)
 This is a list of Automatic Connection (AC) library C members. (It is limited to use during development.)
 
 Automatic Connection (AC) API for Devonly (C++)
 This is a list of Automatic Connection (AC) library C++ members. (It is limited to use during development.)
 
 Automatic Connection (AC) Results
 A list of Results used in the Automatic Connection (AC) library.
 

Namespaces

namespace  nn::ac
 Namespace for the Automatic Connection (AC) Library.
 

Detailed Description

This module controls automatic network connections.

The AC library provides APIs for network connections. It provides easier-to-use wrappers for the functions of the NC library. The NC library is private as of SDK 2.06. NC library calls cannot be included in retail version code.

As its name implies, AC provides functionality for automatic connection to the network. When the profile specified in System Settings can connect, having the system connect automatically reduces the amount of time an application takes to connect using nn::ac::Connect or nn::ac::ConnectAsync.

When you are disconnected from the network for an external reason, having the system attempt to connect periodically improves performance during recovery.

Note that the AC library only connects automatically to the default profile. It does not automatically select the profile to connect to from all those available.

The AC API functions that can be used in general applications are contained in ac_Api.h. Use of the API functions in ac_ApiDebug.h and ac_Config.h is permitted during development, but they must not be included in retail versions.

In retail versions, either include ac.h, or include only ac_Types.h, ac_Result.h, and ac_Api.h (included in ac.h).

If retail version builds produce errors if ac_ApiDebug.h or ac_Config.h is not included, it could be because unauthorized functions are being used.

As long as only permitted functions are used in retail versions, it should not be necessary to access ac_TypesDebug.h, ac_DetailedErrorCode.h, or ac_TypesConfig.h, where structures and constants are defined. Because these are simple definitions, the risk of using them in retail versions is low. These files may be accessed if necessary.

For more information about the AC library, see the API Reference and the sample demos. For information about C functions, see Automatic Connection (AC) API (C). For information about C++ API functions, see Automatic Connection (AC) API (C++).