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 |
|