Función SCardReadCacheW (winscard.h)

La función SCardReadCache recupera la parte de valor de un par nombre-valor de la caché global mantenida por la tarjeta inteligente Resource Manager.

Sintaxis

LONG SCardReadCacheW(
  [in]  SCARDCONTEXT hContext,
  [in]  UUID         *CardIdentifier,
  [in]  DWORD        FreshnessCounter,
  [in]  LPWSTR       LookupName,
  [out] PBYTE        Data,
  [out] 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 una tarjeta inteligente. El par nombre-valor que lee esta función de la caché global está asociado a esta tarjeta inteligente.

[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 para el que se va a recuperar la parte del valor.

[out] Data

Puntero a una matriz de valores de bytes que contienen la parte de valor del par nombre-valor especificado por el parámetro LookupName .

[out] DataLen

Puntero al 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_NOT_FOUND 0x80100070	El par nombre-valor especificado no se encontró en la memoria caché global.
SCARD_W_CACHE_ITEM_STALE 0x80100071	El par nombre-valor especificado era anterior al solicitado y se ha eliminado de la memoria caché.

Comentarios

Nota

El encabezado winscard.h define SCardReadCache 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

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

SCardWriteCache