CardGetFirstTuple

9/8/2008

Essa função recupera a primeira tupla do tipo especificado para a função e Soquete especificado.

Syntax

STATUS CardGetFirstTuple(
  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 identificador Soquete especificado para o hSocket membro de CARD_TUPLE_PARMS não é válido ou que não há nenhum cartão PC inserido na Soquete.

• CERR_NO_MORE_ITEMS
  Indica que o fim da estrutura informações de cartão (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 procura o encadear tupla CIS em memória atributo do PC Card para a tupla especificada pelo uDesiredTuple membro de CARD_TUPLE_PARMS. A uDesiredTuple valor de 0xFF indica que todos os tuplas são retornadas. O driver retém os valores retornados na uLinkOffset, uCISOffset, e fFlags Os membros do CARD_TUPLE_PARMS Para que chamadas subseqüentes para o CardGetNextTuple Ou CardGetTupleData funções execute o encadear tupla. O uTupleCode e uTupleLinkOs membros são ignorados quando o valor de retorno não é CERR_SUCCESS.

Para obter dados tupla, chamar CardGetTupleData.

CARD_TUPLE_PARMS e o CARD_DATA_PARMS estrutura são organizadas para que seus correspondente membros são alinhados. Com cuidado, reserva uma única pode ser usada em todas as chamadas para as funções tupla serviços cartão. Essa função ativa Soquete o PC Card, se ele não estiver na já. O Soquete está desativado se não houver drivers têm memória janelas aberto na PC Card.

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
CardGetNextTuple
CardGetTupleData