Função SCardReadCacheA (winscard.h)

Artigo
11/20/2024

A função SCardReadCache recupera a parte de valor de um par nome-valor do cache global mantido pelodo Gerenciador de Recursos de Cartão Inteligente do .

Sintaxe

LONG SCardReadCacheA(
  [in]  SCARDCONTEXT hContext,
  [in]  UUID         *CardIdentifier,
  [in]  DWORD        FreshnessCounter,
  [in]  LPSTR        LookupName,
  [out] PBYTE        Data,
  [out] DWORD        *DataLen
);

Parâmetros

[in] hContext

Um identificador que identifica ode contexto do gerenciador de recursos . O contexto do gerenciador de recursos é definido por uma chamada anterior para SCardEstablishContext.

[in] CardIdentifier

Um ponteiro para um valor que identifica exclusivamente um cartão inteligente. O par nome-valor que essa função lê do cache global está associado a esse cartão inteligente.

[in] FreshnessCounter

A revisão atual dos dados armazenados em cache.

[in] LookupName

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém a parte de nome do par nome-valor para o qual recuperar a parte do valor.

[out] Data

Um ponteiro para uma matriz de valores de bytes que contêm a parte de valor do par nome-valor especificado pelo parâmetro LookupName.

[out] DataLen

Um ponteiro para o tamanho, em bytes, do buffer Data.

Valor de retorno

Se a função for bem-sucedida, ela retornará SCARD_S_SUCCESS.

Se a função falhar, ela retornará um dos seguintes códigos de erro. Para obter mais informações, consulte valores de retorno de cartão inteligente.

Código/valor de retorno	Descrição
SCARD_W_CACHE_ITEM_NOT_FOUND 0x80100070	O par nome-valor especificado não foi encontrado no cache global.
SCARD_W_CACHE_ITEM_STALE 0x80100071	O par nome-valor especificado era mais antigo do que o solicitado e foi excluído do cache.

Observações

Nota

O cabeçalho winscard.h define SCardReadCache como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2008 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	winscard.h
biblioteca	Winscard.lib
de DLL	Winscard.dll

Consulte também

SCardWriteCache

Compartilhar via