SCardForgetCardTypeA-Funktion (winscard.h)
Die SCardForgetCardType-Funktion entfernt eine eingeführte intelligente Karte aus dem Smart Karte-Subsystem.
Syntax
LONG SCardForgetCardTypeA(
[in] SCARDCONTEXT hContext,
[in] LPCSTR szCardName
);
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] szCardName
Anzeigename des Karte, 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
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 SCardForgetCardType-Funktion ist eine Datenbankverwaltungsfunktion. Weitere Informationen zu anderen Datenbankverwaltungsfunktionen finden Sie unter SmartCard-Datenbankverwaltungsfunktionen.
Beispiele
Im folgenden Beispiel wird der angegebene Karte-Typ aus dem System entfernt. Im Beispiel wird davon ausgegangen, dass lReturn eine gültige Variable vom Typ LONG ist, 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");
Hinweis
Der winscard.h-Header definiert SCardForgetCardType 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 |