# oamBoardLookupByShelfSlot

Looks up a board by its shelf and slot number and returns its name. This information is available only for CompactPCI CG boards in PICMG 2.1-compliant chassis.

#### Prototype

DWORD oamBoardLookupByShelfSlot ( CTAHD ctahd, DWORD dwShelf, DWORD dwSlot, char *szName, DWORD dwNameSize )

Argument | Description
ctahd | [in] Context handle.
dwShelf | [in] Shelf number of chassis containing board to look up.
dwSlot | [in] Slot 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.

#### Details

oamBoardLookupByShelfSlot returns the name of the board with shelf and slot values dwShelf and dwShelf. Shelf and slot information is available only for CompactPCI CG boards in PICMG 2.1-compliant chassis.

dwShelf and dwShelf must be in the range 0 - 31 (5 bits).

For more information, see Retrieving board information.

#### See also

oamBoardLookupByBusSlot, oamBoardLookupByDriverIDs, oamBoardLookupByMACAddress, oamBoardLookupByNumber, oamBoardLookupByProduct, oamBoardLookupBySerialNumber