SCardIntroduceReaderGroupA-Funktion (winscard.h)

Artikel
03/04/2024

Die SCardIntroduceReaderGroup-Funktion führt eine Lesergruppe in das Smart Karte-Subsystem ein. Die Lesergruppe wird jedoch erst erstellt, wenn die Gruppe beim Hinzufügen eines Lesers zur Smart Karte-Datenbank angegeben wird.

Syntax

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

Parameter

[in] hContext

Stellt das Handle bereit, das den Ressourcen-Manager-Kontext identifiziert. Der Ressourcen-Manager-Kontext wird durch einen vorherigen Aufruf der Funktion SCardEstablishContext festgelegt. Wenn dieser Parameter NULL ist, wird der Bereich des Ressourcen-Managers SCARD_SCOPE_SYSTEM.

[in] szGroupName

Gibt den Anzeigenamen an, der der neuen Lesergruppe zugewiesen werden soll.

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

Die SCardIntroduceReaderGroup-Funktion wird für die Kompatibilität der PC/SC-Spezifikation bereitgestellt. Lesergruppen werden erst gespeichert, wenn der Gruppe ein Leser hinzugefügt wird.

Die SCardIntroduceReaderGroup-Funktion ist eine Datenbankverwaltungsfunktion. Eine Beschreibung anderer Datenbankverwaltungsfunktionen finden Sie unter SmartCard-Datenbankverwaltungsfunktionen.

Um eine Lesergruppe zu entfernen, verwenden Sie SCardForgetReaderGroup.

Beispiele

Das folgende Beispiel zeigt die Einführung einer intelligenten Karte Lesergruppe.

// Introduce the reader group.
// lReturn is of type LONG.
// hContext was set by a previous call to SCardEstablishContext.
lReturn = SCardIntroduceReaderGroup(hContext, 
                                    L"MyReaderGroup");
if ( SCARD_S_SUCCESS != lReturn )
    printf("Failed SCardIntroduceReaderGroup\n");

Hinweis

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