IWbemContext::GetValue, méthode (wbemcli.h)

  • Article

La méthode IWbemContext::GetValue est utilisée pour récupérer une valeur de contexte nommée spécifique par nom.

Syntaxe

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

Paramètres

[in] wszName

Nom pour lequel la valeur doit être récupérée. Cela doit pointer vers un BSTR valide. Le pointeur est traité en lecture seule.

[in] lFlags

Réservé. Ce paramètre doit être 0.

[out] pValue

Ce paramètre ne peut pas être NULL et doit pointer vers un VARIANT non initialisé. Si aucune erreur n’est retournée, le VARIANT est initialisé à l’aide de VariantInit, puis défini sur contenir la valeur de contexte. L’appelant doit appeler VariantClear sur ce pointeur lorsque la valeur n’est plus nécessaire. Si un code d’erreur est retourné, le VARIANT pointé par pValue n’est pas modifié.

Il est possible qu’un objet IWbemClassObject entier puisse être retourné à l’intérieur du VARIANT. Si tel est le cas, VT_UNKNOWN est le type VARIANT . L’appelant peut prendre le pointeur IUnknown et exécuter QueryInterface pour obtenir le pointeur IWbemClassObject .

Valeur retournée

Cette méthode retourne une valeur HRESULT qui indique le statut de l'appel de méthode. La liste suivante répertorie la valeur contenue dans un HRESULT.

Configuration requise

   
Client minimal pris en charge Windows Vista
Serveur minimal pris en charge Windows Server 2008
Plateforme cible Windows
En-tête wbemcli.h (include 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::SetValue