# oamBoardGetShelfSlot

Returns the shelf and slot for the board with the given name. This information is available only for CompactPCI CG boards in PICMG 2.1-compliant chassis.

#### Prototype

DWORD oamBoardGetShelfSlot ( CTAHD ctahd, const char *szName, DWORD *pdwShelf, DWORD *pdwSlot )

Argument | Description
ctahd | [in] Context handle.
szName | [in] Pointer to the name of board to look up.
pdwShelf | [out] Pointer to the shelf number of the chassis containing the board.
pdwSlot | [out] Pointer to the board's slot number.

#### Return values

Return value | Description
SUCCESS |
CTAERR_BAD_ARGUMENT | szName, pdwShelf, or pdwSlot is NULL or 0.
CTAERR_SVR_COMM | Natural Access Server is not running.
OAMERR_NOT_FOUND | Board not found.
OAMERR_SERVER_NOT_RUNNING | Supervisor is shut down.

#### Details

oamBoardGetShelfSlot returns the shelf and slot values of board szName.Shelf. Shelf and slot information is available only for CompactPCI CG boards in a PICMG 2.1-compliant chassis.

Shelf and slot values are coded in 5 bits each, so pdwShelf and pdwSlot are both values between 0 and 31. If shelf and slot values cannot be retrieved (for example, if board szName is a PCI board), pdwShelf and pdwSlot are set to illegal value 32.

For more information, see Retrieving board information.

#### See also

oamBoardGetBusSlot, oamBoardGetDriverIDs, oamBoardGetMACAddress, oamBoardGetNumber, oamBoardGetProduct, oamBoardGetSerialNumber, oamBoardGetStatus