Freigeben über


SCardRemoveReaderFromGroupA-Funktion (winscard.h)

Die SCardRemoveReaderFromGroup-Funktion entfernt einen Reader aus einer vorhandenen Lesergruppe. Diese Funktion hat keine Auswirkungen auf den Reader.

Syntax

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

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 zu entfernenden Readers.

[in] szGroupName

Anzeigename der Gruppe, aus der der Reader entfernt werden soll.

Wert Bedeutung
SCARD_ALL_READERS
TEXT("SCard$AllReaders\000")
Die Gruppe wird verwendet, wenn beim Auflisten von Lesern kein Gruppenname angegeben wird. Gibt eine Liste aller Leser zurück, unabhängig davon, in welcher Gruppe oder In welcher Gruppe sich die Leser befinden.
SCARD_DEFAULT_READERS
TEXT("SCard$DefaultReaders\000")
Standardgruppe, der alle Leser hinzugefügt werden, wenn sie in das System eingeführt werden.
SCARD_LOCAL_READERS
TEXT("SCard$LocalReaders\000")
Nicht verwendeter Legacywert. Dies ist eine intern verwaltete Gruppe, die nicht mithilfe von Lesergruppen-APIs geändert werden kann. Sie ist nur für die Enumeration vorgesehen.
SCARD_SYSTEM_READERS
TEXT("SCard$SystemReaders\000")
Nicht verwendeter Legacywert. Dies ist eine intern verwaltete Gruppe, die nicht mithilfe von Lesergruppen-APIs geändert werden kann. Sie ist nur für die Enumeration vorgesehen.

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 letzte Reader aus einer Gruppe entfernt wird, wird die Gruppe automatisch vergessen.

Die SCardRemoveReaderFromGroup-Funktion ist eine Datenbankverwaltungsfunktion. Informationen zu anderen Datenbankverwaltungsfunktionen finden Sie unter Smartcard-Datenbankverwaltungsfunktionen.

Um einer Lesergruppe einen Reader hinzuzufügen, verwenden Sie SCardAddReaderToGroup.

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie einen Reader aus der Gruppe entfernen.

// Remove a reader from the group.
// lReturn is of type LONG.
// hContext was set by a previous call to SCardEstablishContext.
// The group is automatically forgotten if no readers remain in it.
lReturn = SCardRemoveReaderFromGroup(hContext, 
                                     L"MyReader",
                                     L"MyReaderGroup");
if ( SCARD_S_SUCCESS != lReturn )
    printf("Failed SCardRemoveReaderFromGroup\n");

Hinweis

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

   
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

Weitere Informationen

SCardAddReaderToGroup

SCardEstablishContext

SCardForgetCardType

SCardForgetReader

SCardForgetReaderGroup