nn::uds::CTR::GetMacAddress Function

Syntax

nn::Result GetMacAddress(
     bit8 pMacAddress[MAC_ADDRESS_SIZE]
);

Arguments

Name Description
out pMacAddress[MAC_ADDRESS_SIZE] The MAC address of the local host.

Return Values

Returns the function's execution result. Returns one of the Result values listed below.
Value Description
ResultSuccess Process was successful.
ResultNotAuthorized A state where the MAC address could not be acquired. Also returned when the library is not yet initialized.
A value other than the above. Failed for reasons other than those given above.

Description

Gets the MAC address of the local host. (Used in debugging)

This function is used to check and obtain the MAC address of the running device when debugging communication-related features.

The MAC address is a unique value for each system, so it may change if the system is repaired or otherwise modified. To identify a system, use the nn::cfg::GetTransferableId function instead.

Revision History

2010/10/15
Expanded the information on the return values. Indicated that this should not be used for release versions.
2010/06/14
Initial version.

CONFIDENTIAL