SCardForgetCardTypeA-Funktion (winscard.h)

Artikel
11/20/2024

Die funktion SCardForgetCardType entfernt eine eingeführte Smartcard- aus dem Smartcard-Subsystem.

Syntax

LONG SCardForgetCardTypeA(
  [in] SCARDCONTEXT hContext,
  [in] LPCSTR       szCardName
);

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] szCardName

Anzeigename der Karte, die aus der Smartcarddatenbankentfernt 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

Diese Funktion wird nicht umgeleitet, aber das Aufrufen der Funktion SCardForgetCardType in einer Remotedesktopsitzung führt nicht zu einem Fehler. Dies bedeutet nur, dass das Ergebnis vom Remotecomputer statt vom lokalen Computer stammt.

Die funktion SCardForgetCardType ist eine Datenbankverwaltungsfunktion. Weitere Informationen zu anderen Datenbankverwaltungsfunktionen finden Sie unter SmartCard-Datenbankverwaltungsfunktionen.

Beispiele

Im folgenden Beispiel wird der angegebene Kartentyp aus dem System entfernt. Im Beispiel wird davon ausgegangen, dass lReturn eine gültige Variable vom Typ LONGist, dass hContext ein gültiges Handle ist, das von einem vorherigen Aufruf der SCardEstablishContext-Funktion empfangen wurde und dass "MyCardName" zuvor durch einen Aufruf der SCardIntroduceCardType-Funktion eingeführt wurde.


lReturn = SCardForgetCardType(hContext, 
                              L"MyCardName");
if ( SCARD_S_SUCCESS != lReturn )
    printf("Failed SCardForgetCardType\n");

Anmerkung

Der winscard.h-Header definiert SCardForgetCardType 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-

SCardForgetReader-

SCardForgetReaderGroup-

SCardIntroduceCardType

Freigeben über