Função SCardReadCacheA (winscard.h)

A função SCardReadCache recupera a parte de valor de um par nome-valor do cache global mantido pelo Resource Manager cartão inteligente.

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 o 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 do 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 de dados .

Valor retornado

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 retornados de cartão inteligente.

Valor/código retornado	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.

Comentários

Observação

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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winscard.h
Biblioteca	Winscard.lib
DLL	Winscard.dll

Confira também

SCardWriteCache