Fonction SCardReconnect (winscard.h)

Article
03/04/2024

La fonction SCardReconnect rétablit une connexion existante entre l’application appelante et un carte intelligent. Cette fonction déplace un handle de carte de l’accès direct à l’accès général, ou reconnaît et efface une condition d’erreur qui empêche l’accès supplémentaire au carte.

Syntaxe

LONG SCardReconnect(
  [in]            SCARDHANDLE hCard,
  [in]            DWORD       dwShareMode,
  [in]            DWORD       dwPreferredProtocols,
  [in]            DWORD       dwInitialization,
  [out, optional] LPDWORD     pdwActiveProtocol
);

Paramètres

[in] hCard

Valeur de référence obtenue à partir d’un appel précédent à SCardConnect.

[in] dwShareMode

Indicateur qui indique si d’autres applications peuvent former des connexions à ce carte.

Valeur	Signification
SCARD_SHARE_SHARED	Cette application partagera cette carte avec d’autres applications.
SCARD_SHARE_EXCLUSIVE	Cette application ne partagera pas cette carte avec d’autres applications.

[in] dwPreferredProtocols

Masque de bits des protocoles acceptables pour cette connexion. Les valeurs possibles peuvent être combinées à l’opération OR .

La valeur de ce paramètre doit inclure le protocole actuel. La tentative de reconnexion avec un protocole autre que le protocole actuel entraîne une erreur.

Valeur	Signification
SCARD_PROTOCOL_T0	T=0 est un protocole acceptable.
SCARD_PROTOCOL_T1	T=1 est un protocole acceptable.

[in] dwInitialization

Type d’initialisation qui doit être effectuée sur le carte.

Valeur	Signification
SCARD_LEAVE_CARD	Ne faites rien de spécial lors de la reconnexion.
SCARD_RESET_CARD	Réinitialisez le carte (Réinitialisation à chaud).
SCARD_UNPOWER_CARD	Mettez le carte hors tension et réinitialisez-le (Réinitialisation à froid).

[out, optional] pdwActiveProtocol

Indicateur qui indique le protocole actif établi.

Valeur	Signification
SCARD_PROTOCOL_T0	T=0 est le protocole actif.
SCARD_PROTOCOL_T1	T=1 est le protocole actif.

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

SCardReconnect est une fonction d’accès carte et lecteur intelligente. Pour plus d’informations sur d’autres fonctions d’accès, consultez Smart Card and Reader Access Functions.

Exemples

L’exemple suivant montre le rétablissement d’une connexion.

DWORD     dwAP;
LONG      lReturn;

// Reconnect.
// hCardHandle was set by a previous call to SCardConnect.
lReturn = SCardReconnect(hCardHandle,
                         SCARD_SHARE_SHARED,
                         SCARD_PROTOCOL_T0 | SCARD_PROTOCOL_T1,
                         SCARD_LEAVE_CARD,
                         &dwAP );
if ( SCARD_S_SUCCESS != lReturn )
    printf("Failed SCardReconnect\n");

Configuration requise

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]
Plateforme cible	Windows
En-tête	winscard.h
Bibliothèque	Winscard.lib
DLL	Winscard.dll

Voir aussi

SCardConnect

SCardDisconnect

Partager via