CardGetTupleData

This function reads the data from the current tuple.

Syntax

STATUS CardGetTupleData( PCARD_DATA_PARMS pTupleDataParms );

Parameters

pTupleDataParms: Pointer to a CARD_DATA_PARMS structure used to return the tuple data.

Return Values

CERR_SUCCESS indicates success. One of the following values indicates failure:

CERR_BAD_ARG_LENGTH: Indicates that the buffer specified by uBufLen in CARD_DATA_PARMS is not large enough.
CERR_BAD_ARGS: Indicates that the pointer specified by pTupleDataParms is invalid.
CERR_BAD_SOCKET: Indicates that an hSocket socket identifier in the CARD_TUPLE_PARMS structure is invalid or that a PC Card is not inserted.
CERR_NO_MORE_ITEMS: Indicates that the end of CIS is reached or that the requested tuple is not found.
CERR_OUT_OF_RESOURCE: Indicates that Card Services is unable to set up a memory window to read the CIS.
CERR_READ_FAILURE: Indicates that no PC Card is inserted or that the PC Card is unreadable.

Remarks

This function returns data from the tuple specified by the fFlags, uLinkOffset, and uCISOffset members in CARD_DATA_PARMS. The driver maintains these member values whenever CardGetFirstTuple and CardGetNextTuple are called.

Driver Name