Returns the serial number for the board with the given name.
DWORD oamBoardGetSerialNumber ( CTAHD ctahd, const char *szName, char *szSerialNumber, DWORD dwSerialNumberSize )
|
Argument |
Description |
|
ctahd |
[in] Context handle. |
|
szName |
[in] Pointer to the name of board to look up. |
|
szSerialNumber |
[out] Pointer to buffer to receive serial number of board. |
|
dwSerialNumberSize |
[in] Size of szSerialNumber (maximum number of bytes to return, including final null character). |
|
Return value |
Description |
|
SUCCESS |
|
|
CTAERR_BAD_ARGUMENT |
szName or szSerialNumber 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. |
Boards must be started when you invoke oamBoardGetSerialNumber. For more information, see Retrieving board information.
oamBoardGetBusSlot, oamBoardGetDriverIDs, oamBoardGetMACAddress, oamBoardGetNumber, oamBoardGetProduct, oamBoardGetShelfSlot, oamBoardGetStatus