SCardLocateCardsByATRA-Funktion (winscard.h)

Die SCardLocateCardsByATR-funktion durchsucht die leser, die im rgReaderStates Parameter aufgeführt sind, nach einer Karte mit einem Namen, der einem der kartennamen entspricht, 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

Behandeln Sie das Ressourcen-Manager-Kontext. Der Ressourcen-Manager-Kontext wird durch einen vorherigen Aufruf von SCardEstablishContextfestgelegt.

[in] rgAtrMasks

Array von SCARD_ATRMASK Strukturen, die die Namen der zu durchsuchenden Karten enthalten.

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

Bemerkungen

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

Die funktion SCardLocateCardsByATR ist eine Smartcard- Tracking-Funktion. Informationen zu anderen Tracking-Funktionen finden Sie unter SmartCard Tracking Functions.

Anforderungen