SCardAddReaderToGroupA-Funktion (winscard.h)

Artikel
08/27/2023

Die SCardAddReaderToGroup-Funktion fügt einer Lesergruppe einen Reader hinzu.

Syntax

LONG SCardAddReaderToGroupA(
  [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 Lesers, den Sie hinzufügen.

[in] szGroupName

Anzeigename der Gruppe, der Sie den Reader hinzufügen.

Wert	Bedeutung
SCARD_ALL_READERS TEXT("SCard$AllReaders\000")	Gruppe, die verwendet wird, 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

SCardAddReaderToGroup erstellt automatisch die angegebene Lesergruppe, wenn sie noch nicht vorhanden ist.

Die SCardAddReaderToGroup-Funktion ist eine Datenbankverwaltungsfunktion. Weitere Informationen zu anderen Datenbankverwaltungsfunktionen finden Sie unter SmartCard-Datenbankverwaltungsfunktionen.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie sie einer Gruppe einen intelligenten Karte-Reader hinzufügen. Im Beispiel wird davon ausgegangen, dass lReturn eine vorhandene Variable vom Typ LONG ist, dass hContext ein gültiger Handle ist, der von einem vorherigen Aufruf der SCardEstablishContext-Funktion empfangen wurde, und dass "MyReader" und "MyReaderGroup" vom System durch vorherige Aufrufe der Funktionen SCardIntroduceReader und SCardIntroduceReaderGroup bekannt sind.


lReturn = SCardAddReaderToGroup( hContext, 
                                L"MyReader",
                                L"MyReaderGroup");
if ( SCARD_S_SUCCESS != lReturn )
    printf("Failed SCardAddReaderToGroup\n");

Hinweis

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

Anforderung	Wert
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

SCardEstablishContext

SCardIntroduceReader

SCardIntroduceReaderGroup

SCardRemoveReaderFromGroup