Funzione SCardGetDeviceTypeIdA (winscard.h)

Articolo
11/20/2024

La funzione SCardGetDeviceTypeId ottiene l'identificatore del tipo di dispositivo del lettore di schede per il nome lettore specificato. Questa funzione non influisce sullo stato del lettore.

Sintassi

LONG SCardGetDeviceTypeIdA(
  [in]      SCARDCONTEXT hContext,
  [in]      LPCSTR       szReaderName,
  [in, out] LPDWORD      pdwDeviceTypeId
);

Parametri

[in] hContext

Handle che identifica il contesto di Resource Manager per la query. È possibile impostare il contesto di Resource Manager chiamando la funzione SCardEstablishContext. Questo parametro non può essere NULL.

[in] szReaderName

Nome lettore. È possibile ottenere questo valore chiamando la funzione SCardListReaders.

[in, out] pdwDeviceTypeId

Identificatore effettivo del tipo di dispositivo. L'elenco dei tipi di lettore restituiti da questa funzione è elencato in membro ReaderType nella struttura SCARD_READER_CAPABILITIES.

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

Nota

L'intestazione winscard.h definisce SCardGetDeviceTypeId 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 8 [solo app desktop]
server minimo supportato	Windows Server 2012 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	winscard.h
dll	Winscard.dll

Condividi tramite