# oamBoardLookupByMACAddress

Looks up a board by one of the MAC addresses of its Ethernet interfaces and returns its name.

#### Prototype

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 values

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.

#### Details

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.

#### See also

oamBoardLookupByBusSlot, oamBoardLookupByDriverIDs, oamBoardLookupByProduct, oamBoardLookupByShelfSlot, oamBoardLookupByShelfSlot