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 值,请参阅 系统错误代码。
注解
以下算法用于重构方法参数的文本:
- 参数按其标识符值的顺序重新排序。
- 指定为 [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 |