IWiaUIExtension2 :: GetDeviceIcon, méthode

Obtient une icône d’appareil personnalisé.

Syntaxe

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

Paramètres

bstrDeviceId [ dans]

Type : BSTR

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

phIcon [ à]

Type : HICON *

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

nSize [ dans]

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 est réussie, elle retourne la valeur _ OK. Si la méthode échoue, elle retourne un code d’erreur approprié. Le tableau suivant présente certains des codes d’état 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 _ échec Aucune ressource icône n’est disponible.
_NOTIMPL E Aucune icône de la taille demandée n’est disponible.

Configuration requise

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