SCardWriteCacheW, fonction (winscard.h)

Article
11/20/2024

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

Syntaxe

LONG SCardWriteCacheW(
  [in] SCARDCONTEXT hContext,
  [in] UUID         *CardIdentifier,
  [in] DWORD        FreshnessCounter,
  [in] LPWSTR       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 à puce à 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’octets 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 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_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

Note

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

SCardReadCache

Partager via