GetObjectText 函数
返回托管对象格式 (MOF) 语法中对象的文本呈现。
注意
此 API 仅供内部使用。 不应从开发人员代码中使用。
语法
HRESULT GetObjectText (
[in] int vFunc,
[in] IWbemClassObject* ptr,
[in] LONG lFlags,
[out] BSTR* pstrObjectText
);
参数
vFunc
[in] 未使用此参数。
ptr
[in] 指向 IWbemClassObject 实例的指针。
lFlags
[in] 通常为 0。 如果指定了 WBEM_FLAG_NO_FLAVORS（或 0x1），则包含限定符但不包含传播或风格信息。
pstrObjectText [out] 指向 null 的指针。 返回包含对象的 MOF 语法呈现的新分配的 BSTR。
返回值
此函数返回的以下值是在 WbemCli.h 头文件中定义的，你也可以在代码中将这些值定义为常数：
| 常数 | Value | 说明 |
|---|---|---|
WBEM_E_FAILED |
0x80041001 | 发生一般性故障。 |
WBEM_E_INVALID_PARAMETER |
0x80041008 | 参数无效。 |
WBEM_E_OUT_OF_MEMORY |
0x80041006 | 没有足够的可用内存来完成该操作。 |
WBEM_S_NO_ERROR |
0 | 函数调用成功。 |
注解
此函数包装对 IWbemClassObject::GetObjectText 方法的调用。
返回的 MOF 文本不包含有关对象的所有信息，而仅包含使 MOF 编译器能够重新创建原始对象的足够信息。 例如，不包括传播的限定符或父类属性。
以下算法用于重构方法参数的文本：
- 参数按其标识符值的顺序重新排序。
- 指定为
[in]和[out]的参数合并为一个参数。
调用函数时，pstrObjectText 必须是指向 null 的指针；它不能指向在方法调用之前有效的字符串，因为指针不会被释放。
要求
平台：请参阅系统要求。
标头：WMINet_Utils.idl
.NET Framework 版本：自 4.7.2 起可用
