Funzione SCardLocateCardsByATRW (winscard.h)

Articolo
11/20/2024

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

Sintassi

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

Parametri

[in] hContext

Handle che identifica il contesto di gestione risorse . 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
esito positivo	SCARD_S_SUCCESS.
errore	Codice di errore. Per altre informazioni, vedere valori restituiti della smart card.

Osservazioni

Questo servizio è particolarmente utile quando viene usato insieme a SCardGetStatusChange. Se non viene trovata alcuna scheda corrispondente tramite SCardLocateCards, l'applicazione chiamante può usare SCardGetStatusChange attendere le modifiche alla disponibilità delle schede.

La funzione di SCardLocateCardsByATR è una funzione di rilevamento smart card. Per informazioni su altre funzioni di rilevamento, vedere Funzioni di rilevamento delle 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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	winscard.h
libreria	Winscard.lib
dll	Winscard.dll

Condividi tramite