Funzione SCardLocateCardsByATRA (winscard.h)
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 |
---|---|
|
SCARD_S_SUCCESS. |
|
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 |