Fonction SCardDisconnect (winscard.h)

Article
08/27/2023

La fonction SCardDisconnect met fin à une connexion précédemment ouverte entre l’application appelante et un carte intelligent dans le lecteur cible.

Syntaxe

LONG SCardDisconnect(
  [in] SCARDHANDLE hCard,
  [in] DWORD       dwDisposition
);

Paramètres

[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
SCARD_LEAVE_CARD	Ne faites rien de spécial.
SCARD_RESET_CARD	Réinitialisez le carte.
SCARD_UNPOWER_CARD	Mettez le carte hors tension.
SCARD_EJECT_CARD	Éjectez le carte.

Valeur retournée

Cette fonction retourne des valeurs différentes selon qu’elle réussit ou échoue.

Code de retour	Description
Success	SCARD_S_SUCCESS.
Échec	Code d'erreur. Pour plus d’informations, consultez Valeurs de retour de carte à puce.

Remarques

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 et lecteur intelligente. Pour plus d’informations sur les autres fonctions d’accès, consultez Fonctions d’accès aux cartes à puce et aux lecteurs.

Exemples

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.
}

Configuration requise


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

Voir aussi

SCardConnect

SCardReconnect

Partager via