SCardGetDeviceTypeIdA-Funktion (winscard.h)

Artikel
11/20/2024

Die SCardGetDeviceTypeId-Funktion ruft den Gerätetypbezeichner des Kartenlesers für den angegebenen Lesernamen ab. Diese Funktion wirkt sich nicht auf den Status des Readers aus.

Syntax

LONG SCardGetDeviceTypeIdA(
  [in]      SCARDCONTEXT hContext,
  [in]      LPCSTR       szReaderName,
  [in, out] LPDWORD      pdwDeviceTypeId
);

Parameter

[in] hContext

Behandeln Sie dies, um den Ressourcen-Manager-Kontext für die Abfrage zu identifizieren. Sie können den Ressourcen-Manager-Kontext festlegen, indem Sie die funktion SCardEstablishContext aufrufen. Dieser Parameter darf nicht NULL sein.

[in] szReaderName

Lesename. Sie können diesen Wert abrufen, indem Sie die funktion SCardListReaders aufrufen.

[in, out] pdwDeviceTypeId

Der tatsächliche Gerätetypbezeichner. Die Liste der von dieser Funktion zurückgegebenen Lesetypen wird unter ReaderType Member in der SCARD_READER_CAPABILITIES-Struktur aufgeführt.

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

Anmerkung

Der winscard.h-Header definiert SCardGetDeviceTypeId 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 8 [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2012 [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	winscard.h
DLL-	Winscard.dll

Freigeben über