Share via

Fonction SCardDisconnect (winscard.h)

  • Article

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 etlecteur 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