Auto Connect C API

C functions for the Auto Connect API. More...

Typedefs
typedef uint32_t	ACConfigId
	An ID number representing a network configuration. More...

Functions
NNResult	ACInitialize ()
	Initialise the Auto Connect library. More...
void	ACFinalize ()
	Cleanup the Auto Connect library. More...
NNResult	ACGetStartupId (ACConfigId *configId)
	Gets the default connection configuration id. More...
NNResult	ACConnectWithConfigId (ACConfigId configId)
	Connects to a network, using the configuration represented by the given ACConfigId. More...
NNResult	ACGetAssignedAddress (uint32_t *ip)
	Gets the IP address assosciated with the currently active connection. More...

Detailed Description

C functions for the Auto Connect API.

Typedef Documentation

ACConfigId

typedef uint32_t ACConfigId

An ID number representing a network configuration.

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

Definition at line 20 of file ac_c.h.

Function Documentation

ACInitialize()

NNResult ACInitialize

(

)

Initialise the Auto Connect library.

Call this function before any other AC functions.

Returns

A Result - see NNResult_IsSuccess and NNResult_IsFailure.

See also

• ACFinalize

ACFinalize()

void ACFinalize

(

)

Cleanup the Auto Connect library.

Do not call any AC functions (other than ACInitialize) after calling this function.

See also

• ACInitialize

ACGetStartupId()

NNResult ACGetStartupId

(

ACConfigId *

configId

)

Gets the default connection configuration id.

This is the default as marked in System Settings.

Parameters

configId

A pointer to an ACConfigId to write the config ID to. Must not be NULL.

Returns

A Result - see NNResult_IsSuccess and NNResult_IsFailure.

ACConnectWithConfigId()

NNResult ACConnectWithConfigId

(

ACConfigId

configId

)

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

Parameters

configId

The ACConfigId representing the network to connect to.

Returns

A Result - see NNResult_IsSuccess and NNResult_IsFailure.

ACGetAssignedAddress()

NNResult ACGetAssignedAddress

(

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 NNResult_IsSuccess and NNResult_IsFailure.