Funzione SCardGetDeviceTypeIdA (winscard.h)

  • Articolo

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
Success
 SCARD_S_SUCCESS.
Operazioni non riuscite
 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