Partager via

Méthode IWiaUIExtension2::GetDeviceIcon

  • Article

Obtient une icône d’appareil personnalisé.

Syntaxe

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

Paramètres

bstrDeviceId [in]

Type : BSTR

Spécifie l’ID d’appareil de l’appareil WIA pour lequel l’icône doit être obtenue.

phIcon [out]

Type : HICON*

Pointe vers un emplacement de mémoire qui recevra un handle pour l’icône de l’appareil.

nSize [in]

Type : ULONG

Spécifie la taille d’icône souhaitée, en pixels. L’icône est supposée être carrée et nSize spécifie à la fois la largeur et la hauteur de l’icône demandée.

Valeur retournée

Type : HRESULT

Si la méthode réussit, retourne S_OK. Si la méthode échoue, elle retourne un code d’erreur approprié. Le tableau suivant présente certains des codes status de retour possibles.

Code d'erreur Description
E_INVALIDARG Le paramètre bstrDeviceId ou phIcon a la valeur NULL, ou bstrDeviceId ne pointe pas vers une chaîne d’ID d’appareil WIA valide
E_FAIL Aucune ressource d’icône n’est disponible.
E_NOTIMPL Aucune icône de la taille demandée n’est disponible.

 

Spécifications

Condition requise Valeur
Client minimal pris en charge
 Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge
 Windows Server 2003 [applications de bureau uniquement]
En-tête
Wiadevd.h