Méthode IWbemContext ::SetValue (wbemcli.h)

  • Article

La méthode IWbemContext ::SetValue crée ou remplace une valeur de contexte nommée.

Syntaxe

HRESULT SetValue(
  [in] LPCWSTR wszName,
  [in] long    lFlags,
  [in] VARIANT *pValue
);

Paramètres

[in] wszName

Impossible d’avoir la valeur NULL. Il s’agit d’un pointeur en lecture seule qui indique le nom de la valeur de contexte. Cette valeur doit être terminée par null.

[in] lFlags

Réservé. Ce paramètre doit être égal à 0 (zéro).

[in] pValue

Doit pointer vers un VARIANT valide, qui est traité en lecture seule. La valeur dans le VARIANT devient la valeur de contexte nommée. Un objet IWbemClassObject entier peut être stocké ainsi qu’une valeur simple en le plaçant dans un variant qui utilise le type VT_UNKNOWN . L’appelant doit exécuter QueryInterface sur l’objet IWbemClassObject en demandant IID_IUnknown et en utilisant le pointeur retourné dans le VARIANT.

Si pValue doit contenir un objet IWbemClassObject incorporé, l’appelant doit appeler IWbemClassObject ::QueryInterface pour IID_IUnknown et placer le pointeur résultant dans le VARIANT à l’aide d’un type de VT_UNKNOWN. L’objet incorporé d’origine est copié pendant l’opération d’écriture et ne peut donc pas être modifié par l’opération.

Valeur retournée

Cette méthode retourne un HRESULT qui indique la status d’un appel de méthode. La liste suivante répertorie et décrit les valeurs contenues dans un HRESULT.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista
Serveur minimal pris en charge Windows Server 2008
Plateforme cible Windows
En-tête wbemcli.h (inclure Wbemidl.h)
Bibliothèque Wbemuuid.lib
DLL Esscli.dll ; Fastprox.dll ; FrameDyn.dll ; FrameDynOS.dll ; Wbemcomn.dll ; Wbemcore.dll ; Wbemess.dll ; Wmipjobj.dll

Voir aussi

IWbemContext

IWbemContext ::GetValue