ISCardVerify::ChangeCode, méthode

Article
06/13/2023

[La méthode ChangeCode est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il n’est pas disponible pour une utilisation dans Windows Server 2003 avec Service Pack 1 (SP1) et versions ultérieures, Windows Vista, Windows Server 2008 et les versions ultérieures du système d’exploitation. Les modules de carte à puce offrent des fonctionnalités similaires.]

La méthode ChangeCode remplace le code CHV (vérification du titulaire carte) actuel par le nouveau code CHV.

Syntaxe

HRESULT ChangeCode(
  [in] LPBYTEBUFFER pOldCode,
  [in] LPBYTEBUFFER pNewCode,
  [in] SCARD_FLAGS  Flags,
  [in] LONG         lRef
);

Paramètres

pOldCode [in]

Pointeur vers un IByteBuffer contenant le code actuel de l’utilisateur.

pNewCode [in]

Pointeur vers un IByteBuffer contenant le nouveau code qui sera présenté au carte intelligent pendant le processus de modification pour authentifier l’utilisateur.

Indicateurs [in]

Indique si le code est global ou local et si le code doit être activé ou désactivé.

SC_FL_IHV_GLOBAL
SC_FL_IHV_LOCAL
SC_FL_IHV_ENABLE
SC_FL_IHV_DISABLE

lRef [in]

Smart carte référence spécifique.

Valeur retournée

La méthode retourne l’une des valeurs possibles suivantes :

Code de retour	Description
S_OK	Opération exécutée avec succès.
E_INVALIDARG	Paramètre non valide.
E_POINTER	Un pointeur incorrect a été passé.
E_OUTOFMEMORY	Mémoire insuffisante.

Notes

Pour obtenir la liste de toutes les méthodes définies par cette interface, consultez ISCardVerify.

En plus des codes d’erreur COM répertoriés ci-dessus, cette interface peut renvoyer un code d’erreur smart carte si une fonction de carte intelligente a été appelée pour terminer la demande. Pour plus d’informations, consultez Valeurs de retour de carte à puce.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Fin de la prise en charge des clients	Windows XP
Fin de la prise en charge des serveurs	Windows Server 2003

Voir aussi

IByteBuffer
ISCardVerify
Valeurs de retour de carte à puce

Partager via