nn::ac Namespace Reference

Auto Connect API, used for managing and connecting to internet connection profiles. More...

Typedefs
using	ConfigIdNum = uint32_t
	An ID number representing a network configuration.
using	Config = NetConfCfg
	The configuration for a given network profile (from 1 to 6).
using	ErrorCode = uint32_t

Enumerations
enum	Status {   STATUS_FAILED = -1 ,   STATUS_OK = 0 ,   STATUS_PROCESSING = 1 }

Functions
nn::Result	BeginLocalConnection (bool unknown) asm("BeginLocalConnection__Q2_2nn2acFb")
void	ClearConfig (Config *cfg) asm("ClearConfig__Q2_2nn2acFP16netconf_profile_")
nn::Result	Close () asm("Close__Q2_2nn2acFv")
nn::Result	CloseAll () asm("CloseAll__Q2_2nn2acFv")
nn::Result	Connect (const Config *cfg) asm("Connect__Q2_2nn2acFPC16netconf_profile_")
nn::Result	Connect (ConfigIdNum id) asm("Connect__Q2_2nn2acFQ3_2nn2ac11ConfigIdNum")
nn::Result	Connect () asm("Connect__Q2_2nn2acFv")
nn::Result	ConnectAsync (const Config *cfg) asm("ConnectAsync__Q2_2nn2acFPC16netconf_profile_")
nn::Result	ConnectAsync (ConfigIdNum id) asm("ConnectAsync__Q2_2nn2acFQ3_2nn2ac11ConfigIdNum")
	Connects to a network, using the configuration represented by the given ConfigIdNum.
nn::Result	ConnectAsync () asm("ConnectAsync__Q2_2nn2acFv")
nn::Result	ConnectWithRetry () asm("ConnectWithRetry__Q2_2nn2acFv")
nn::Result	DeleteConfig (ConfigIdNum id) asm("DeleteConfig__Q2_2nn2acFQ3_2nn2ac11ConfigIdNum")
nn::Result	EndLocalConnection () asm("EndLocalConnection__Q2_2nn2acFv")
void	Finalize () asm("Finalize__Q2_2nn2acFv")
	Cleans up the Auto Connect library.
nn::Result	GetAssignedAddress (uint32_t *ip) asm("GetAssignedAddress__Q2_2nn2acFPUl")
	Gets the IP address assosciated with the currently active connection.
nn::Result	GetAssignedAlternativeDns (uint32_t *ip) asm("GetAssignedAlternativeDns__Q2_2nn2acFPUl")
nn::Result	GetAssignedGateway (uint32_t *ip) asm("GetAssignedGateway__Q2_2nn2acFPUl")
nn::Result	GetAssignedPreferedDns (uint32_t *ip) asm("GetAssignedPreferedDns__Q2_2nn2acFPUl")
nn::Result	GetAssignedSubnet (uint32_t *ip) asm("GetAssignedSubnet__Q2_2nn2acFPUl")
nn::Result	GetCloseStatus (Status *status) asm("GetCloseStatus__Q2_2nn2acFPQ3_2nn2ac6Status")
nn::Result	GetCompatId (ConfigIdNum *id) asm("GetCompatId__Q2_2nn2acFPQ3_2nn2ac11ConfigIdNum")
nn::Result	GetConnectResult (nn::Result *result) asm("GetConnectResult__Q2_2nn2acFPQ2_2nn6Result")
nn::Result	GetConnectStatus (Status *status) asm("GetConnectStatus__Q2_2nn2acFPQ3_2nn2ac6Status")
nn::Result	GetLastErrorCode (ErrorCode *error) asm("GetLastErrorCode__Q2_2nn2acFPUi")
nn::Result	GetRunningConfig (Config *cfg) asm("GetRunningConfig__Q2_2nn2acFP16netconf_profile_")
nn::Result	GetStartupId (ConfigIdNum *id) asm("GetStartupId__Q2_2nn2acFPQ3_2nn2ac11ConfigIdNum")
	Gets the default connection configuration id.
nn::Result	Initialize () asm("Initialize__Q2_2nn2acFv")
	Initializes the Auto Connect library.
nn::Result	IsAnyKeepingConnect (bool keeping) asm("IsAnyKeepingConnect__Q2_2nn2acFPb")
nn::Result	IsApplicationConnected (bool *connected) asm("IsApplicationConnected__Q2_2nn2acFPb")
nn::Result	IsAutoConnectionFatallyFailed (nn::Result *failed) asm("IsAutoConnectionFatallyFailed__Q2_2nn2acFQ2_2nn6Result")
nn::Result	IsConfigExisting (ConfigIdNum id, bool *existing) asm("IsConfigExisting__Q2_2nn2acFQ3_2nn2ac11ConfigIdNumPb")
nn::Result	IsKeepingConnect (bool *keeping) asm("IsKeepingConnect__Q2_2nn2acFPb")
nn::Result	IsReadyToConnect (bool *ready) asm("IsReadyToConnect__Q2_2nn2acFPb")
nn::Result	ReadConfig (ConfigIdNum id, Config *cfg) asm("ReadConfig__Q2_2nn2acFQ3_2nn2ac11ConfigIdNumP16netconf_profile_")
nn::Result	SetCompatId (ConfigIdNum id) asm("SetCompatId__Q2_2nn2acFQ3_2nn2ac11ConfigIdNum")
nn::Result	SetStartupId (ConfigIdNum id) asm("SetStartupId__Q2_2nn2acFQ3_2nn2ac11ConfigIdNum")
nn::Result	WriteConfig (ConfigIdNum id, const Config *cfg) asm("WriteConfig__Q2_2nn2acFQ3_2nn2ac11ConfigIdNumPC16netconf_profile_")

Detailed Description

Auto Connect API, used for managing and connecting to internet connection profiles.

Typedef Documentation

ConfigIdNum

using ConfigIdNum = uint32_t

An ID number representing a network configuration.

These are the same IDs as shown in System Settings' Connection List.

Definition at line 28 of file ac_cpp.h.

Config

using Config = NetConfCfg

The configuration for a given network profile (from 1 to 6).

See also

NetConfCfg

Definition at line 34 of file ac_cpp.h.

ErrorCode

using ErrorCode = uint32_t

Definition at line 36 of file ac_cpp.h.

Enumeration Type Documentation

Status

enum Status

Enumerator
STATUS_FAILED
STATUS_OK
STATUS_PROCESSING

Definition at line 38 of file ac_cpp.h.

Function Documentation

BeginLocalConnection()

nn::Result BeginLocalConnection

(

bool

unknown

)

ClearConfig()

void ClearConfig

(

Config *

cfg

)

Close()

nn::Result Close

(

)

CloseAll()

nn::Result CloseAll

(

)

Connect() [1/3]

nn::Result Connect

(

const Config *

cfg

)

Connect() [2/3]

nn::Result Connect

(

ConfigIdNum

id

)

Connect() [3/3]

nn::Result Connect

(

)

ConnectAsync() [1/3]

nn::Result ConnectAsync

(

const Config *

cfg

)

ConnectAsync() [2/3]

nn::Result ConnectAsync

(

ConfigIdNum

id

)

Connects to a network, using the configuration represented by the given ConfigIdNum.

Parameters

id	The ConfigIdNum representing the network to connect to.

Returns

A Result - see nn::Result::IsSuccess and nn::Result::IsFailure.

ConnectAsync() [3/3]

nn::Result ConnectAsync

(

)

ConnectWithRetry()

nn::Result ConnectWithRetry

(

)

DeleteConfig()

nn::Result DeleteConfig

(

ConfigIdNum

id

)

EndLocalConnection()

nn::Result EndLocalConnection

(

)

Finalize()

void Finalize

(

)

Cleans up the Auto Connect library.

Do not call any nn::ac functions (other than Initialize) after calling this function.

See also

• Initialize

GetAssignedAddress()

nn::Result GetAssignedAddress

(

uint32_t *

ip

)

Gets the IP address assosciated with the currently active connection.

Parameters

ip	A pointer to write the IP address to, in numerical form.

Returns

A Result - see nn::Result::IsSuccess and nn::Result::IsFailure.

GetAssignedAlternativeDns()

nn::Result GetAssignedAlternativeDns

(

uint32_t *

ip

)

GetAssignedGateway()

nn::Result GetAssignedGateway

(

uint32_t *

ip

)

GetAssignedPreferedDns()

nn::Result GetAssignedPreferedDns

(

uint32_t *

ip

)

GetAssignedSubnet()

nn::Result GetAssignedSubnet

(

uint32_t *

ip

)

GetCloseStatus()

nn::Result GetCloseStatus

(

Status *

status

)

GetCompatId()

nn::Result GetCompatId

(

ConfigIdNum *

id

)

GetConnectResult()

nn::Result GetConnectResult

(

nn::Result *

result

)

GetConnectStatus()

nn::Result GetConnectStatus

(

Status *

status

)

GetLastErrorCode()

nn::Result GetLastErrorCode

(

ErrorCode *

error

)

GetRunningConfig()

nn::Result GetRunningConfig

(

Config *

cfg

)

GetStartupId()

nn::Result GetStartupId

(

ConfigIdNum *

id

)

Gets the default connection configuration id.

This is the default as marked in System Settings.

Parameters

id	A pointer to an ConfigIdNum to write the config ID to. Must not be a nullptr.

Returns

A Result - see nn::Result::IsSuccess and nn::Result::IsFailure.

Initialize()

nn::Result Initialize

(

)

Initializes the Auto Connect library.

Call this function before any other nn::ac functions.

Returns

A Result - see nn::Result::IsSuccess and nn::Result::IsFailure.

See also

• Finalize

IsAnyKeepingConnect()

nn::Result IsAnyKeepingConnect

(

bool

keeping

)

IsApplicationConnected()

nn::Result IsApplicationConnected

(

bool *

connected

)

IsAutoConnectionFatallyFailed()

nn::Result IsAutoConnectionFatallyFailed

(

nn::Result *

failed

)

IsConfigExisting()

nn::Result IsConfigExisting	(	ConfigIdNum	id,
		bool *	existing
	)

IsKeepingConnect()

nn::Result IsKeepingConnect

(

bool *

keeping

)

IsReadyToConnect()

nn::Result IsReadyToConnect

(

bool *

ready

)

ReadConfig()

nn::Result ReadConfig	(	ConfigIdNum	id,
		Config *	cfg
	)

SetCompatId()

nn::Result SetCompatId

(

ConfigIdNum

id

)

SetStartupId()

nn::Result SetStartupId

(

ConfigIdNum

id

)

WriteConfig()

nn::Result WriteConfig	(	ConfigIdNum	id,
		const Config *	cfg
	)