Metodo IWiaUIExtension2::GetDeviceIcon

Articolo
06/13/2023

Ottiene un'icona del dispositivo personalizzata.

Sintassi

HRESULT GetDeviceIcon(
  [in]  BSTR  bstrDeviceId,
  [out] HICON *phIcon,
  [in]  ULONG nSize
);

Parametri

bstrDeviceId [in]

Tipo: BSTR

Specifica l'ID dispositivo del dispositivo WIA per il quale deve essere ottenuta l'icona.

phIcon [out]

Tipo: HICON*

Punta a un percorso di memoria che riceverà un handle per l'icona per il dispositivo.

nSize [in]

Tipo: ULONG

Specifica le dimensioni dell'icona desiderate, in pixel. Si presuppone che l'icona sia quadrata e nSize specifichi sia la larghezza che l'altezza dell'icona richiesta.

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, viene restituito S_OK. Se il metodo ha esito negativo, restituisce un codice di errore appropriato. La tabella seguente illustra alcuni dei possibili codici di stato restituiti.

Codice di errore	Descrizione
E_INVALIDARG	Il parametro bstrDeviceId o phIcon è NULL oppure bstrDeviceId non punta a una stringa di ID dispositivo WIA valida
E_FAIL	Non è disponibile alcuna risorsa icona.
E_NOTIMPL	Non è disponibile alcuna icona delle dimensioni richieste.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	Wiadevd.h