Looks up a board by one of the MAC addresses of its Ethernet interfaces and returns its name.
DWORD oamBoardLookupByMACAddress ( CTAHD ctahd, const char *szMACAddress, char *szName, DWORD dwNameSize )
|
Argument |
Description |
|
ctahd |
[in] Context handle. |
|
szMACAddress |
[in] Pointer to a MAC address of one of the Ethernet chips on the board to look up. |
|
szName |
[out] Pointer to buffer to receive name of board. |
|
dwNameSize |
[in] Size of szName (maximum number of bytes to return including final null character). |
|
Return value |
Description |
|
SUCCESS |
|
|
CTAERR_BAD_ARGUMENT |
szName is NULL or 0. |
|
CTAERR_SVR_COMM |
Natural Access Server is not running. |
|
OAMERR_NOT_ENOUGH_MEMORY |
Specified buffer size is too small. |
|
OAMERR_NOT_FOUND |
Board not found. |
|
OAMERR_SERVER_NOT_RUNNING |
Supervisor is shut down. |
oamBoardLookupByMACAddress retrieves the name of the board with MAC address szMACAddress. MAC addresses are available only with boards with Ethernet interfaces. Each chip has a unique address.
szMACAddress is a string containing a standard MAC address; that is, 6 hexadecimal byte values separated by hyphens. For example:
E3-31-23-4A-2E-3F
For more information, see Retrieving board information.
oamBoardLookupByBusSlot, oamBoardLookupByDriverIDs, oamBoardLookupByProduct, oamBoardLookupByShelfSlot, oamBoardLookupByShelfSlot