Funzione SCardGetDeviceTypeIdA (winscard.h)
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 |
---|---|
|
SCARD_S_SUCCESS. |
|
Codice di errore. Per altre informazioni, vedere Valori restituiti smart card. |
Commenti
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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows 8 [solo app desktop] |
Server minimo supportato | Windows Server 2012 [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | winscard.h |
DLL | Winscard.dll |