Partager via


Fonction SCardReconnect (winscard.h)

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