Fonction SCardWriteCacheA (winscard.h)
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 |
---|---|
|
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 |