oamBoardLookupByBusSlot

Looks up a board by its PCI bus and slot and returns its name. For more information, see Retrieving board information.

Prototype

DWORD oamBoardLookupByBusSlot ( CTAHD ctahd, DWORD dwBus, DWORD dwSlot, char *szName, DWORD dwNameSize )

Argument

Description

ctahd

[in] Context handle.

dwBus

[in] PCI bus number of board to look up.

dwSlot

[in] Number of 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.


See also

oamBoardLookupByDriverIDs, oamBoardLookupByMACAddress, oamBoardLookupByNumber, oamBoardLookupByProduct, oamBoardLookupByShelfSlot