Compartir a través de

Función SCardReadCacheA (winscard.h)

  • Artículo

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

Sintaxis

LONG SCardReadCacheA(
  [in]  SCARDCONTEXT hContext,
  [in]  UUID         *CardIdentifier,
  [in]  DWORD        FreshnessCounter,
  [in]  LPSTR        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 esta función lee de la caché global está asociada 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 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_NOT_FOUND
0x80100070
 No se encontró el par nombre-valor especificado en la caché global.
SCARD_W_CACHE_ITEM_STALE
0x80100071
 El par nombre-valor especificado era anterior al solicitado y se eliminó de la memoria caché.

Observaciones

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

SCardWriteCache