Microsoft Windows CE 3.0  

CardGetTupleData

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

This function reads the data from the current tuple.

STATUS CardGetTupleData(
PCARD_DATA_PARMS
pTupleDataParms
);

Parameters

pTupleDataParms
Pointer to a CARD_DATA_PARMSstructure 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 uBufLenin CARD_DATA_PARMSis not large enough.
CERR_BAD_ARGS
Indicates that the pointer specified by pTupleDataParmsis invalid.
CERR_BAD_SOCKET
Indicates that an hSocketsocket identifier in the CARD_TUPLE_PARMSstructure is invalid or that a PC Card is not inserted.
CERR_NO_MORE_ITEMS
Indicates that the end of CIS has been reached or that the requested tuple was 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 uCISOffsetmembers in CARD_DATA_PARMS. The driver maintains these member values whenever the CardGetFirstTupleand CardGetNextTuplefunctions are called.

Driver name

PCMCIA

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 1.0 and later      
Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

CARD_DATA_PARMS, CARD_TUPLE_PARMS, CardGetFirstTuple, CardGetNextTuple, CardGetParsedTuple



 Last updated on Tuesday, July 13, 2004

© 2004 Microsoft Corporation. All rights reserved.