Freigeben über


SCardLocateCardsByATRA-Funktion (winscard.h)

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