Funzione SCardLocateCardsByATRA (winscard.h)

Articolo
03/08/2023

La funzione SCardLocateCardsByATR cerca nei lettori elencati nel parametro rgReaderStates una scheda con un nome corrispondente a uno dei nomi di scheda contenuti in una delle strutture SCARD_ATRMASK specificate dal parametro rgAtrMasks .

Sintassi

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

Parametri

[in] hContext

Handle che identifica il contesto di Resource Manager. Il contesto di Resource Manager viene impostato da una chiamata precedente a SCardEstablishContext.

[in] rgAtrMasks

Matrice di strutture SCARD_ATRMASK che contengono i nomi delle schede in cui eseguire la ricerca.

[in] cAtrs

Numero di elementi nella matrice rgAtrMasks .

[in, out] rgReaderStates

Matrice di strutture SCARD_READERSTATE che specificano i lettori da cercare e ricevono il risultato.

[in] cReaders

Numero di elementi nella matrice rgReaderStates .

Valore restituito

Questa funzione restituisce valori diversi a seconda che abbia esito positivo o negativo.

Codice restituito	Descrizione
Success	SCARD_S_SUCCESS.
Operazioni non riuscite	Codice di errore. Per altre informazioni, vedere Valori restituiti della smart card.

Commenti

Questo servizio è particolarmente utile quando usato insieme a SCardGetStatusChange. Se non vengono trovate schede corrispondenti tramite SCardLocateCards, l'applicazione chiamante può usare SCardGetStatusChange per attendere le modifiche alla disponibilità delle schede.

La funzione SCardLocateCardsByATR è una funzione di rilevamento smart card . Per informazioni su altre funzioni di rilevamento, vedere Funzioni di rilevamento smart card.

Nota

L'intestazione winscard.h definisce SCardLocateCardsByATR come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winscard.h
Libreria	Winscard.lib
DLL	Winscard.dll