Fonction SCardWriteCacheA (winscard.h)

Article
08/27/2023

La fonction SCardWriteCache écrit une paire nom-valeur à partir d’un carte intelligent dans le cache global géré par le Resource Manager de carte à puce.

Syntaxe

LONG SCardWriteCacheA(
  [in] SCARDCONTEXT hContext,
  [in] UUID         *CardIdentifier,
  [in] DWORD        FreshnessCounter,
  [in] LPSTR        LookupName,
  [in] PBYTE        Data,
  [in] 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 la carte intelligente à partir de laquelle la paire nom-valeur a été lue.

[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 à écrire dans le cache global.

[in] Data

Pointeur vers un tableau de valeurs d’octet qui contiennent la partie valeur de la paire nom-valeur à écrire dans le cache global.

[in] DataLen

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_TOO_BIG 0x80100072	La taille de la paire nom-valeur spécifiée dépasse la taille maximale définie pour le cache global.

Remarques

Notes

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

SCardReadCache

Share via