SCardReconnect-Funktion (winscard.h)

Artikel
03/04/2024

Die SCardReconnect-Funktion stellt eine vorhandene Verbindung zwischen der aufrufenden Anwendung und einer intelligenten Karte wieder her. Diese Funktion verschiebt ein Karte Handle vom direkten Zugriff auf den allgemeinen Zugriff oder bestätigt und löscht eine Fehlerbedingung, die den weiteren Zugriff auf die Karte verhindert.

Syntax

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

Parameter

[in] hCard

Verweiswert, der von einem vorherigen Aufruf von SCardConnect abgerufen wurde.

[in] dwShareMode

Flag, das angibt, ob andere Anwendungen Verbindungen zu diesem Karte herstellen können.

Wert	Bedeutung
SCARD_SHARE_SHARED	Diese Anwendung teilt diese Karte mit anderen Anwendungen.
SCARD_SHARE_EXCLUSIVE	Diese Anwendung teilt diese Karte nicht mit anderen Anwendungen.

[in] dwPreferredProtocols

Bitmaske von akzeptablen Protokollen für diese Verbindung. Mögliche Werte können mit dem OR-Vorgang kombiniert werden.

Der Wert dieses Parameters sollte das aktuelle Protokoll enthalten. Der Versuch, die Verbindung mit einem anderen Protokoll als dem aktuellen Protokoll wiederherzustellen, führt zu einem Fehler.

Wert	Bedeutung
SCARD_PROTOCOL_T0	T=0 ist ein akzeptables Protokoll.
SCARD_PROTOCOL_T1	T=1 ist ein akzeptables Protokoll.

[in] dwInitialization

Art der Initialisierung, die für die Karte ausgeführt werden soll.

Wert	Bedeutung
SCARD_LEAVE_CARD	Machen Sie beim Erneuten Verbinden nichts Besonderes.
SCARD_RESET_CARD	Setzen Sie die Karte zurück (Warm Reset).
SCARD_UNPOWER_CARD	Schalten Sie die Karte herunter, und setzen Sie sie zurück (Cold Reset).

[out, optional] pdwActiveProtocol

Flag, das das etablierte aktive Protokoll angibt.

Wert	Bedeutung
SCARD_PROTOCOL_T0	T=0 ist das aktive Protokoll.
SCARD_PROTOCOL_T1	T=1 ist das aktive Protokoll.

Rückgabewert

Diese Funktion gibt unterschiedliche Werte zurück, je nachdem, ob sie erfolgreich ist oder fehlschlägt.

Rückgabecode	BESCHREIBUNG
Erfolgreich	SCARD_S_SUCCESS.
Fehler	Ein Fehlercode. Weitere Informationen finden Sie unter Smartcard-Rückgabewerte.

Hinweise

SCardReconnect ist eine intelligente Karte- und Leserzugriffsfunktion. Weitere Informationen zu anderen Zugriffsfunktionen finden Sie unter Smartcard- und Lesezugriffsfunktionen.

Beispiele

Das folgende Beispiel zeigt, wie eine Verbindung wiederhergestellt wird.

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");

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winscard.h
Bibliothek	Winscard.lib
DLL	Winscard.dll

Weitere Informationen

SCardConnect

SCardDisconnect

Freigeben über