SCardForgetReaderA-Funktion (winscard.h)
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 |
|---|---|
|
SCARD_S_SUCCESS. |
|
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 |