Fonction SCardDisconnect (winscard.h)
La fonction SCardDisconnect met fin à une connexion précédemment ouverte entre l’application appelante et un carte intelligent dans le lecteur cible.
LONG SCardDisconnect(
[in] SCARDHANDLE hCard,
[in] DWORD dwDisposition
);
[in] hCard
Valeur de référence obtenue à partir d’un appel précédent à SCardConnect.
[in] dwDisposition
Action à entreprendre sur le carte dans le lecteur connecté à la fermeture.
Valeur | Signification |
---|---|
|
Ne faites rien de spécial. |
|
Réinitialisez le carte. |
|
Mettez le carte hors tension. |
|
Éjectez le carte. |
Cette fonction retourne des valeurs différentes selon qu’elle réussit ou échoue.
Code de retour | Description |
---|---|
|
SCARD_S_SUCCESS. |
|
Code d'erreur. Pour plus d’informations, consultez Valeurs de retour de carte à puce. |
Si une application (qui s’appelait précédemment SCardConnect) se ferme sans appeler SCardDisconnect, la carte est automatiquement réinitialisée.
La fonction SCardDisconnect est une fonction d’accès carte etlecteur intelligente. Pour plus d’informations sur les autres fonctions d’accès, consultez Fonctions d’accès aux cartes à puce et aux lecteurs.
L’exemple suivant met fin à la connexion smart carte spécifiée. L’exemple suppose que lReturn est une variable de type LONG et que hCardHandle est un handle valide reçu à partir d’un appel précédent à SCardConnect.
lReturn = SCardDisconnect(hCardHandle,
SCARD_LEAVE_CARD);
if ( SCARD_S_SUCCESS != lReturn )
{
printf("Failed SCardDisconnect\n");
exit(1); // Or other appropriate action.
}
Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
Plateforme cible | Windows |
En-tête | winscard.h |
Bibliothèque | Winscard.lib |
DLL | Winscard.dll |