IWbemClassObjectObject::GetObjectText, méthode (wbemcli.h)

  • Article

La méthode IWbemClassObject::GetObjectText retourne un rendu textuel de l’objet dans la syntaxe MOF. Notez que le texte MOF retourné ne contient pas toutes les informations sur l’objet, mais seulement suffisamment d’informations pour que le compilateur MOF puisse recréer l’objet d’origine. Par instance, aucun qualificateur propagé ou propriété de classe parente n’est affiché.

Syntaxe

HRESULT GetObjectText(
  [in]  long lFlags,
  [out] BSTR *pstrObjectText
);

Paramètres

[in] lFlags

Normalement 0. Si WBEM_FLAG_NO_FLAVORS est spécifié, les qualificateurs sont présentés sans informations de propagation ou de saveur.

[out] pstrObjectText

Cela doit pointer vers NULL lors de l’entrée. Ce paramètre reçoit de Windows Management un BSTR nouvellement alloué qui a été initialisé avec SysAllocString. Vous devez appeler SysFreeString sur le pointeur lorsque la chaîne n’est plus nécessaire. Ce pointeur pointe vers un rendu de la syntaxe MOF de l’objet lors du retour de l’appel. Étant donné qu’il s’agit d’un paramètre out, le pointeur ne doit pas pointer vers une chaîne valide avant l’appel de cette méthode, car le pointeur ne sera pas libéré.

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. Pour connaître les valeurs HRESULT générales, consultez Codes d’erreur système.

Remarques

L’algorithme suivant est utilisé pour reconstruire le texte des paramètres d’une méthode :

  1. Les paramètres sont resequencés dans l’ordre de leurs valeurs d’identificateur.
  2. Les paramètres spécifiés comme [in] et [out] sont combinés en un seul paramètre.

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 CIMWin32.dll; Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll; Wbemess.dll; Wmipiprt.dll

Voir aussi

IWbemClassObject

IWbemQualifierSet

WBEM_TEXT_FLAG_TYPE