CardGetNextTuple

9/8/2008

Essa função recupera o próximo tupla do tipo especificado para a função e Soquete especificado.

Syntax

STATUS CardGetNextTuple(
  PCARD_TUPLE_PARMS pGetTupleParms 
);

Parameters

• pGetTupleParms
  [out] Ponteiro para um CARD_TUPLE_PARMS estrutura.

Return Value

CERR_SUCCESS indica sucesso. Um do seguinte valores indica falha:

• CERR_BAD_ARGS
  Indica que o ponteiro especificado para pGetTupleParms não é válido.

• CERR_BAD_SOCKET
  Indica que o hSocket identificador Soquete in CARD_TUPLE_PARMS não é válido ou que nenhuma placa PC é inserida na Soquete.

• CERR_NO_MORE_ITEMS
  Indica que a fim de cartão informações estrutura (CIS) foi alcançado ou que a tupla solicitada não foi encontrada.

• CERR_OUT_OF_RESOURCE
  Indica que os serviços cartão é Não é possível configurar uma janela memória para ler o CIS.

• CERR_READ_FAILURE
  Indica que nenhuma placa PC é inserida ou se o cartão PC está ilegível.

Remarks

Essa função segue o encadear tupla CIS, conforme especificado pelo uLinkOffset, uCISOffset, e fFlags Os membros do CARD_TUPLE_PARMS. Esses membros foram definidos por um chamar anterior para o CardGetFirstTuple função ou essa função.

Para obter dados tupla, use CardGetTupleData.

O driver retém os valores retornados na uLinkOffset, uCISOffset, e fFlags Os membros do CARD_TUPLE_PARMS Para que chamadas subseqüentes para esta função ou CardGetTupleData pode seguir o encadear tupla. O driver não acessar a uTupleCode e uTupleLinkOs membros a menos que o valor de retorno CERR_SUCCESS.

O CARD_TUPLE_PARMS e CARD_DATA_PARMS estruturas são organizadas para que seus correspondente membros são alinhados. Com cuidado, drivers podem usar uma reserva única em todas as chamadas para as funções tupla serviços cartão.

Requirements

Header	cardsv2.h
Library	Pcc_serv.dll
Windows Embedded CE	Windows CE 1.0 and later

See Also

Reference

CARD_DATA_PARMS
CARD_TUPLE_PARMS
CardGetFirstTuple
CardGetTupleData