SCardForgetReaderA-Funktion (winscard.h)

Artikel
11/20/2024

Die -Funktion SCardForgetReader entfernt eine zuvor eingeführte Reader- aus der Steuerung durch das Smartcard-Subsystem. Sie wird aus der Smartcarddatenbankentfernt, einschließlich aus einer beliebigen Lesergruppe, zu der sie möglicherweise hinzugefügt wurde.

Syntax

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

Parameter

[in] hContext

Behandeln Sie das Ressourcen-Manager-Kontext. Der Ressourcen-Manager-Kontext wird durch einen vorherigen Aufruf von SCardEstablishContextfestgelegt. Dieser Parameter kann nicht NULL-werden.

[in] szReaderName

Der Anzeigename des Lesers, der aus der Smartcarddatenbank entfernt werden soll.

Rückgabewert

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

Rückgabecode	Beschreibung
Erfolg	SCARD_S_SUCCESS.
Fehler	Fehlercode. Weitere Informationen finden Sie unter Smartcard-Rückgabewerte.

Bemerkungen

Wenn der angegebene Leser 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 Kartenlesers aus dem System entfernt. In diesem 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");

Anmerkung

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

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	winscard.h
Library	Winscard.lib
DLL-	Winscard.dll

Siehe auch

SCardEstablishContext-

SCardForgetCardType-

SCardForgetReaderGroup-

SCardIntroduceReader-

Freigeben über