Fonction SCardReadCacheA (winscard.h)

Article
08/27/2023

La fonction SCardReadCache récupère la partie valeur d’une paire nom-valeur à partir du cache global géré par le Resource Manager de carte à puce.

Syntaxe

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

Paramètres

[in] hContext

Handle qui identifie le contexte resource manager. Le contexte resource manager est défini par un appel précédent à SCardEstablishContext.

[in] CardIdentifier

Pointeur vers une valeur qui identifie de manière unique un carte intelligent. La paire nom-valeur que cette fonction lit à partir du cache global est associée à cette carte intelligente.

[in] FreshnessCounter

Révision actuelle des données mises en cache.

[in] LookupName

Pointeur vers une chaîne terminée par null qui contient la partie nom de la paire nom-valeur pour laquelle récupérer la partie valeur.

[out] Data

Pointeur vers un tableau de valeurs d’octet qui contiennent la partie valeur de la paire nom-valeur spécifiée par le paramètre LookupName .

[out] DataLen

Pointeur vers la taille, en octets, de la mémoire tampon de données .

Valeur retournée

Si la fonction réussit, elle retourne SCARD_S_SUCCESS.

Si la fonction échoue, elle retourne l’un des codes d’erreur suivants. Pour plus d’informations, consultez Valeurs de retour de carte à puce.

Code/valeur de retour	Description
SCARD_W_CACHE_ITEM_NOT_FOUND 0x80100070	La paire nom-valeur spécifiée n’a pas été trouvée dans le cache global.
SCARD_W_CACHE_ITEM_STALE 0x80100071	La paire nom-valeur spécifiée était antérieure à celle demandée et a été supprimée du cache.

Remarques

Notes

L’en-tête winscard.h définit SCardReadCache comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winscard.h
Bibliothèque	Winscard.lib
DLL	Winscard.dll

Voir aussi

SCardWriteCache

Share via