IWbemClassObject::GetObjectText 方法 (wbemcli.h)

IWbemClassObject::GetObjectText 方法以 MOF 语法返回对象的文本呈现。 请注意,返回的 MOF 文本不包含有关对象的所有信息,而只包含足够的信息,供 MOF 编译器重新创建原始对象。 例如,不显示传播的限定符或父类属性。

语法

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

参数

[in] lFlags

通常为 0。 如果指定 了WBEM_FLAG_NO_FLAVORS ,则表示限定符时不会显示传播或风格信息。

[out] pstrObjectText

这必须在输入时指向 NULL 。 此参数从 Windows 管理接收使用 SysAllocString 初始化的新分配的 BSTR。 不再需要字符串时,必须在指针上调用 SysFreeString 。 此指针指向从调用返回时对象的 MOF 语法呈现。 由于这是 out 参数,因此指针在调用此方法之前不得指向有效的字符串,因为不会解除分配指针。

返回值

此方法返回指示方法调用状态的 HRESULT。 以下列表列出了 HRESULT 中包含的值。 有关常规 HRESULT 值,请参阅 系统错误代码

注解

以下算法用于重构方法参数的文本:

  1. 参数按其标识符值的顺序重新排序。
  2. 指定为 [in] 和 [out] 的参数将合并为单个参数。

要求

   
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
目标平台 Windows
标头 wbemcli.h (包括 Wbemidl.h)
Library WbemUuid.lib
DLL CIMWin32.dll;Esscli.dll;Fastprox.dll;FrameDyn.dll;FrameDynOS.dll;Krnlprov.dll;Ncprov.dll;Wbemcore.dll;Wbemess.dll;Wmipiprt.dll

另请参阅

IWbemClassObject

IWbemQualifierSet

WBEM_TEXT_FLAG_TYPE