CardGetParsedTuple
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Esta função lê e decodifica as tuplas CISTPL_CONFIG e CISTPL_CFTABLE_ENTRY. Esses tuplas são tanto complexa e difícil decodificar. Essa função armazena as informações desses tuplas em estruturas dados que são mais fáceis de serem acessar.
Syntax
STATUS CardGetParsedTuple(
CARD_SOCKET_HANDLE hSocket,
UINT8 uDesiredTuple,
PVOID pBuf,
PUINT32 pnItems
);
Parameters
- hSocket
[no] Identificador para um par Soquete e função.
- uDesiredTuple
[no] Especifica a tupla desejada para analisar. Atualmente, apenas as tuplas CISTPL_CONFIG ou CISTPL_CFTABLE_ENTRY são com suporte para análise.
- pBuf
[out] Ponteiro para a reserva para conter as informações tupla analisada. Aponta para o PARSED_CONFIG ou o PARSED_CFTABLE estrutura.
- pnItems
[in, Out] Ponteiro, na entrada, para o número de entradas na reserva apontada pelo pBuf. Em sair, este parâmetro especifica quantas entradas de pBuf São necessários para armazenar os resultados ou quantas entradas são exigido se a reserva não for grande o suficiente.
Return Value
CERR_SUCCESS indica sucesso. Um do seguinte valores indica falha:
- CERR_BAD_ARG_LENGTH
Indica que a reserva especificado pelo pnItems ponteiro não é grande o suficiente.
- CERR_BAD_ARGS
Indica que o ponteiro especificado por pBuf não é válido.
- CERR_BAD_SOCKET
Indica que um hSocket identificador Soquete não é válido ou se um cartão PC não está inserido.
- CERR_NO_MORE_ITEMS
Indica que o fim da estrutura informações cartão (CIS) for alcançado ou que a tupla solicitada não for 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
Esta função lê os dados CIS do Cartão de PC especificado de codificar a tupla especificada e formata os dados codificados em uma estrutura facilmente acessada. Essa função reduz tamanho codificar, eliminando o adicional exigido processamento para analisar alguns tuplas de comprimento variável, que reduz a duplicação do exigido codificar para processo esses tuplas.
Atualmente, apenas as tuplas CISTPL_CONFIG e CISTPL_CFTABLE_ENTRY são com suporte para análise.
Quando essa função é chamado com CISTPL_CONFIG, ele recupera uma PARSED_CONFIG estrutura. Quando é chamado com CISTPL_CFTABLE_ENTRY, ele recupera uma PARSED_CFTABLE estrutura. Portanto, o pBuf ponteiro aponta para um PARSED_CONFIG Ou PARSED_CFTABLE.
Se não houver múltiplo tuplas CISTPL_CFTABLE_ENTRY, essa função recupera o exigido número de PARSED_CFTABLE estruturas.
Requirements
| Header | cardsv2.h |
| Library | Pcc_serv.dll |
| Windows Embedded CE | Windows CE 1.0 and later |