Função SCardWriteCacheA (winscard.h)

Artigo
11/20/2024

A função SCardWriteCache grava um par nome-valor de um cartão inteligente no cache global mantido pelodo Gerenciador de Recursos de Cartão Inteligente do .

Sintaxe

LONG SCardWriteCacheA(
  [in] SCARDCONTEXT hContext,
  [in] UUID         *CardIdentifier,
  [in] DWORD        FreshnessCounter,
  [in] LPSTR        LookupName,
  [in] PBYTE        Data,
  [in] 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 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 de 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 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_TOO_BIG 0x80100072	O tamanho do par nome-valor especificado excede o tamanho máximo definido para o cache global.

Observações

Nota

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

SCardReadCache

Compartilhar via