SCardForgetReaderA-Funktion (winscard.h)

Artikel
08/27/2023

Die SCardForgetReader-Funktion entfernt einen zuvor eingeführten Reader aus der Steuerung durch das Smart Karte-Subsystem. Sie wird aus der Smart Karte-Datenbank entfernt, einschließlich aus jeder Lesergruppe, der sie möglicherweise hinzugefügt wurde.

Syntax

LONG SCardForgetReaderA(
  [in] SCARDCONTEXT hContext,
  [in] LPCSTR       szReaderName
);

Parameter

[in] hContext

Handle, das den Ressourcen-Manager-Kontext identifiziert. Der Ressourcen-Manager-Kontext wird durch einen vorherigen Aufruf von SCardEstablishContext festgelegt. Dieser Parameter darf nicht NULL sein.

[in] szReaderName

Anzeigename des Lesers, der aus der Smart Karte-Datenbank entfernt werden soll.

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

Wenn der angegebene Reader das letzte Mitglied einer Lesergruppe ist, wird auch die Lesergruppe automatisch entfernt.

Die SCardForgetReader-Funktion ist eine Datenbankverwaltungsfunktion. Weitere Informationen zu anderen Datenbankverwaltungsfunktionen finden Sie unter SmartCard-Datenbankverwaltungsfunktionen.

Beispiele

Im folgenden Beispiel wird der Anzeigename des angegebenen Karte-Readers aus dem System entfernt. Im Beispiel wird davon ausgegangen, dass lReturn eine gültige Variable vom Typ LONG ist und dass hContext ein gültiges Handle ist, das von einem vorherigen Aufruf der SCardEstablishContext-Funktion empfangen wurde.


lReturn = SCardForgetReader(hContext, 
                            TEXT("MyReader"));
if ( SCARD_S_SUCCESS != lReturn )
    printf("Failed SCardForgetReader\n");

Hinweis

Der winscard.h-Header definiert SCardForgetReader als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen


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