nn::uds::CTR::CreateNetwork Function

Syntax

nn::Result CreateNetwork(
     u8 subId,
     u8 maxEntry,
     bit32 localId,
     const char passphrase[],
     size_t passphraseLength
);

nn::Result CreateNetwork(
     u8 subId,
     u8 maxEntry,
     bit32 localId,
     const char passphrase[],
     size_t passphraseLength,
     const void * pData,
     size_t dataSize
);

nn::Result CreateNetwork(
     u8 subId,
     u8 maxEntry,
     bit32 localId,
     const char passphrase[],
     size_t passphraseLength,
     u8 channel
);

nn::Result CreateNetwork(
     u8 subId,
     u8 maxEntry,
     bit32 localId,
     const char passphrase[],
     size_t passphraseLength,
     u8 channel,
     const void * pData,
     size_t dataSize
);

List of Overloaded Member Functions

CreateNetwork(u8, u8, bit32, const char, size_t) Creates a new network.
CreateNetwork ( u8, u8, bit32, const char, size_t, const void *, size_t ) Sets optional data for the beacon and builds a new network.
CreateNetwork(u8, u8, bit32, const char, size_t, u8) Creates a new network. This function is provided for debugging purposes and can be used to specify the channel to use for wireless communication during development. Note that the channel argument is ignored on production hardware.
CreateNetwork ( u8, u8, bit32, const char, size_t, u8, const void *, size_t ) Sets optional data for the beacon and builds a new network. This function is provided for debugging purposes, and can be used to specify the channel to use for wireless communication during development. Note that the channel argument is ignored on production hardware.

Description of CreateNetwork(u8, u8, bit32, const char, size_t)

Approximately 800 ms is required for completion, in order to then auto-select channels or perform similar processes.

This function is thread-safe.

Description of CreateNetwork ( u8, u8, bit32, const char, size_t, const void *, size_t )

Approximately 800 ms is needed to complete this because auto-selection of channels and other operations must be performed.

Using this API function allows you to set optional data for the beacon, when building the network. To update the optional data for the beacon after the network has been constructed, use the SetApplicationDataToBeacon function. The maximum size of this optional data is NET_DESC_APPDATA_SIZE_MAX bytes. Since it is not encrypted, note that it can be collected by any general device, such as a computer. Other devices can obtain this data by calling Scan, while they are connected as clients or spectators. This function is thread-safe.

Description of CreateNetwork(u8, u8, bit32, const char, size_t, u8)

Approximately 800 ms is required for completion, in order to then auto-select channels or perform similar processes.

This function is thread-safe.

Description of CreateNetwork ( u8, u8, bit32, const char, size_t, u8, const void *, size_t )

Approximately 800 ms is needed to complete this, because auto-selection of channels and other operations must be performed.

Using this API function allows you to set optional data for the beacon, when building the network. To update the optional data for the beacon after the network has been constructed, use the SetApplicationDataToBeacon function. The maximum size of this optional data is NET_DESC_APPDATA_SIZE_MAX bytes. Since it is not encrypted, note that it can be collected by any general device, such as a computer. Other devices can obtain this data by calling Scan, while they are connected as clients or spectators. This function is thread-safe.

CONFIDENTIAL