Partager via


IDeviceSpecificProperty ::SetValue, méthode (devicetopology.h)

La méthode SetValue définit la valeur de la propriété spécifique à l’appareil.

Syntaxe

HRESULT SetValue(
  [in] void    *pvValue,
  [in] DWORD   cbValue,
  [in] LPCGUID pguidEventContext
);

Paramètres

[in] pvValue

Pointeur vers la nouvelle valeur de la propriété spécifique à l’appareil.

[in] cbValue

Taille en octets de la valeur de la propriété spécifique à l’appareil.

[in] pguidEventContext

Valeur de contexte pour la méthode IControlChangeNotify ::OnNotify . Ce paramètre pointe vers un GUID de contexte d’événement. Si l’appel SetValue modifie l’état du contrôle, tous les clients qui ont des interfaces IControlChangeNotify inscrites avec ce contrôle reçoivent des notifications. Dans son implémentation de la méthode OnNotify , un client peut inspecter le GUID de contexte d’événement pour déterminer s’il est ou un autre client la source de l’événement control-change. Si l’appelant fournit un pointeur NULL pour ce paramètre, la méthode de notification du client reçoit un pointeur de contexte NULL .

Valeur retournée

Si la méthode réussit, retourne S_OK. En cas d’échec, les codes de retour possibles incluent, sans s’y limiter, les valeurs indiquées dans le tableau suivant.

Code de retour Description
E_POINTER
Le pointeur pvValue a la valeur NULL.
E_INVALIDARG
Le paramètre cbValue ne correspond pas à la taille requise de la valeur de la propriété.
E_OUTOFMEMORY
Mémoire insuffisante.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête devicetopology.h

Voir aussi

IDeviceSpecificProperty, interface