SCardReadCacheW, fonction (winscard.h)

Article
11/20/2024

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

Syntaxe

LONG SCardReadCacheW(
  [in]  SCARDCONTEXT hContext,
  [in]  UUID         *CardIdentifier,
  [in]  DWORD        FreshnessCounter,
  [in]  LPWSTR       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 façon unique une carte à puce. La paire nom-valeur que cette fonction lit à partir du cache global est associée à cette carte à puce.

[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’octets 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 données .

Valeur de retour

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.

Retourner le code/la valeur	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 plus ancienne que demandée et a été supprimée du cache.

Remarques

Note

L’en-tête winscard.h définit SCardReadCache comme 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2008 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	winscard.h
bibliothèque	Winscard.lib
DLL	Winscard.dll

Voir aussi

SCardWriteCache

Partager via