Compartir a través de

Función SCardWriteCacheA (winscard.h)

  • Artículo

La función SCardWriteCache escribe un par nombre-valor de una tarjeta inteligente en la caché global mantenida por el administrador de recursos de tarjeta inteligente .

Sintaxis

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

Parámetros

[in] hContext

Identificador que identifica el contexto del administrador de recursos . El contexto del administrador de recursos se establece mediante una llamada anterior a SCardEstablishContext.

[in] CardIdentifier

Puntero a un valor que identifica de forma única la tarjeta inteligente desde la que se leyó el par nombre-valor.

[in] FreshnessCounter

Revisión actual de los datos almacenados en caché.

[in] LookupName

Puntero a una cadena terminada en null que contiene la parte de nombre del par nombre-valor que se va a escribir en la memoria caché global.

[in] Data

Puntero a una matriz de valores de bytes que contienen la parte de valor del par nombre-valor que se va a escribir en la caché global.

[in] DataLen

Tamaño, en bytes, del búfer de datos de .

Valor devuelto

Si la función se ejecuta correctamente, devuelve SCARD_S_SUCCESS.

Si se produce un error en la función, devuelve uno de los siguientes códigos de error. Para obtener más información, consulte valores devueltos de tarjeta inteligente.

Código y valor devueltos Descripción
SCARD_W_CACHE_ITEM_TOO_BIG
0x80100072
 El tamaño del par nombre-valor especificado supera el tamaño máximo definido para la caché global.

Observaciones

Nota

El encabezado winscard.h define SCardWriteCache como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2008 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de winscard.h
biblioteca de Winscard.lib
DLL de Winscard.dll

Consulte también

SCardReadCache