SCardLocateCardsByATRA-Funktion (winscard.h)

Artikel
08/27/2023

Die SCardLocateCardsByATR-Funktion durchsucht die im rgReaderStates-Parameter aufgeführten Reader nach einem Karte mit einem Namen, der mit einem der Karte Namen übereinstimmt, die in einer der SCARD_ATRMASK Strukturen enthalten sind, die durch den rgAtrMasks-Parameter angegeben sind.

Syntax

LONG SCardLocateCardsByATRA(
  [in]      SCARDCONTEXT         hContext,
  [in]      LPSCARD_ATRMASK      rgAtrMasks,
  [in]      DWORD                cAtrs,
  [in, out] LPSCARD_READERSTATEA rgReaderStates,
  [in]      DWORD                cReaders
);

Parameter

[in] hContext

Handle, das den Ressourcen-Manager-Kontext identifiziert. Der Ressourcen-Manager-Kontext wird durch einen vorherigen Aufruf von SCardEstablishContext festgelegt.

[in] rgAtrMasks

Array von SCARD_ATRMASK Strukturen, die die Namen der Karten enthalten, nach denen gesucht werden soll.

[in] cAtrs

Anzahl der Elemente im rgAtrMasks-Array .

[in, out] rgReaderStates

Array von SCARD_READERSTATE Strukturen, die die zu durchsuchenden Leser angeben und das Ergebnis erhalten.

[in] cReaders

Anzahl der Elemente im rgReaderStates-Array .

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	Fehlercode Weitere Informationen finden Sie unter Smartcard-Rückgabewerte.

Hinweise

Dieser Dienst ist besonders nützlich, wenn er in Verbindung mit SCardGetStatusChange verwendet wird. Wenn keine übereinstimmenden Karten mithilfe von SCardLocateCards gefunden werden, kann die aufrufende Anwendung SCardGetStatusChange verwenden, um auf Karte Verfügbarkeitsänderungen zu warten.

Die SCardLocateCardsByATR-Funktion ist eine intelligente Karte-Nachverfolgungsfunktion. Informationen zu anderen Nachverfolgungsfunktionen finden Sie unter Smartcard-Nachverfolgungsfunktionen.

Hinweis

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


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