SCardAddReaderToGroupA-Funktion (winscard.h)

Artikel
11/20/2024

Die funktion SCardAddReaderToGroup fügt eine Reader- einer Lesergruppehinzu.

Syntax

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

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

Anzeigename des Lesers, den Sie hinzufügen.

[in] szGroupName

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

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 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 Lesegruppen-APIs geändert werden kann. Es ist nur für Enumerationen vorgesehen.
SCARD_SYSTEM_READERS TEXT("SCard$SystemReaders\000")	Nicht verwendeter Legacywert. Dies ist eine intern verwaltete Gruppe, die nicht mithilfe von Lesegruppen-APIs geändert werden kann. Es ist nur für Enumerationen vorgesehen.

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

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

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

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie einer Gruppe einen Smartcardleser hinzufügen. Im Beispiel wird davon ausgegangen, dass lReturn eine vorhandene Variable vom Typ LONGist, 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 SCardIntroduceReader und SCardIntroduceReaderGroup- funktionen bekannt sind, beziehungsweise.


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

Anmerkung

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

SCardIntroduceReader-

SCardIntroduceReaderGroup-

SCardRemoveReaderFromGroup-

Freigeben über