CardGetTupleData (Windows CE 5.0)

Send Feedback

This function reads the data from the current tuple.

STATUS CardGetTupleData(PCARD_DATA_PARMSpTupleDataParms);

Parameters

  • pTupleDataParms
    [out] 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 not valid.
  • CERR_BAD_SOCKET
    Indicates that an hSocket socket identifier in the CARD_TUPLE_PARMS structure is not valid or that a PC Card is not inserted.
  • CERR_NO_MORE_ITEMS
    Indicates that the end of card information structure (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 uCISOffset members in CARD_DATA_PARMS. The driver maintains these member values whenever the CardGetFirstTuple and CardGetNextTuple functions are called.

Requirements

OS Versions: Windows CE 1.0 and later.
Header: Cardsv2.h.
Link Library: Pcc_serv.dll

See Also

CARD_DATA_PARMS | CARD_TUPLE_PARMS | CardGetFirstTuple | CardGetNextTuple | CardGetParsedTuple

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.