SCardGetDeviceTypeIdA-Funktion (winscard.h)

Artikel
03/06/2024

Die SCardGetDeviceTypeId-Funktion ruft den Gerätetypbezeichner des Karte-Lesers für den angegebenen Lesernamen ab. Diese Funktion wirkt sich nicht auf den Zustand des Lesers aus.

Syntax

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

Parameter

[in] hContext

Handle, das den Ressourcen-Manager-Kontext für die Abfrage identifiziert. Sie können den Ressourcen-Manager-Kontext festlegen, indem Sie die SCardEstablishContext-Funktion aufrufen. Dieser Parameter darf nicht NULL sein.

[in] szReaderName

Lesername. Sie können diesen Wert abrufen, indem Sie die SCardListReaders-Funktion aufrufen.

[in, out] pdwDeviceTypeId

Der tatsächliche Gerätetypbezeichner. Die Liste der von dieser Funktion zurückgegebenen Lesertypen 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
Erfolgreich	SCARD_S_SUCCESS.
Fehler	Ein Fehlercode. Weitere Informationen finden Sie unter Smartcard-Rückgabewerte.

Hinweise

Hinweis

Der winscard.h-Header definiert SCardGetDeviceTypeId 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 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winscard.h
DLL	Winscard.dll

Freigeben über