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.

Comentários

Requisitos

Confira também

SCardWriteCache