Função SCardWriteCacheW (winscard.h)

  • Artigo

A função SCardWriteCache grava um par nome-valor de um cartão inteligente no cache global mantido pela Resource Manager cartão inteligente.

Sintaxe

LONG SCardWriteCacheW(
  [in] SCARDCONTEXT hContext,
  [in] UUID         *CardIdentifier,
  [in] DWORD        FreshnessCounter,
  [in] LPWSTR       LookupName,
  [in] PBYTE        Data,
  [in] 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 o cartão inteligente do qual o par nome-valor foi lido.

[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 a ser gravada no cache global.

[in] Data

Um ponteiro para uma matriz de valores de bytes que contêm a parte de valor do par nome-valor a ser gravado no cache global.

[in] DataLen

O tamanho, em bytes, do buffer de dados .

Retornar valor

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_TOO_BIG
0x80100072
 O tamanho do par nome-valor especificado excede o tamanho máximo definido para o cache global.

Comentários

Observação

O cabeçalho winscard.h define SCardWriteCache 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

Requisito Valor
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

SCardReadCache