Función SCardReadCacheA (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 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 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 |
---|---|
|
El par nombre-valor especificado no se encontró en la memoria caché global. |
|
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
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
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de