Función SCardWriteCacheA (winscard.h)

La función SCardWriteCache escribe un par nombre-valor de una tarjeta inteligente en la memoria caché global mantenida por la tarjeta inteligente Resource Manager.

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 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 memoria caché global.

[in] DataLen

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

Valor devuelto

Si la función se realiza 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 o valor devuelto	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 memoria caché global.

Comentarios

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 Convenciones para prototipos de función.

Requisitos

Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winscard.h
Library	Winscard.lib
Archivo DLL	Winscard.dll

Consulte también

SCardReadCache