Freigeben über

SCardIntroduceReaderGroupA-Funktion (winscard.h)

Die funktion SCardIntroduceReaderGroup führt eine Lesergruppe zum Smartcard--Subsystem ein. Die Lesergruppe wird jedoch erst erstellt, wenn die Gruppe beim Hinzufügen eines Readers zur Smartcarddatenbankangegeben wird.

Syntax

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

Parameter

[in] hContext

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

[in] szGroupName

Stellt den Anzeigenamen bereit, der der neuen Lesergruppe zugewiesen 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 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

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

Die funktion SCardIntroduceReaderGroup 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 Smartcardlesergruppe.

// 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");

Anmerkung

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

SCardAddReaderToGroup-

SCardEstablishContext-

SCardForgetReaderGroup-

SCardIntroduceCardType

SCardIntroduceReader-

  • Last updated on