描述
IWbemClassObject.GetObjectText方法以MOF语法返回对象的文本呈现。请注意,返回的MOF文本不包含有关对象的所有信息,但只有MOF编译器能够重新创建原始对象的足够信息。例如,不显示传播的限定符或父类属性。
C++ 语法
HRESULT GetObjectText( [in] LONG lFlags, [out] BSTR *pstrObjectText ); |
PowerBASIC 语法
METHOD GetObjectText ( _ BYVAL lFlags AS LONG, _ BYREF pstrObjectText AS WSTRING _ ) AS LONG |
参数
lFlags
通常0。如果指定了WBEM_FLAG_NO_FLAVORS,则不会传播或风味信息将显示限定符。如果指定了WBEM_FLAG_NO_SEPARATOR,则在MOF文本中将省略类或实例声明之后的分号。这些标志可以组合。
pstrObjectText
一个新的BSTR的地址,它接收MOF语法中对象的文本呈现。在调用该方法之前,此参数不能指向有效的字符串,因为这是一个输出参数,并且该调用完成后该指针不会被释放。
返回值
此方法返回一个HRESULT,表示方法调用的状态。下表列出了HRESULT中包含的值。
退货代码 |
描述 |
WBEM_E_FAILED |
发生未指定的错误。 |
WBEM_E_INVALID_PARAMETER |
指定了无效参数。 |
WBEM_E_OUT_OF_MEMORY |
没有足够的内存来完成操作。 |
WBEM_S_NO_ERROR |
通话成功。 |
备注
以下算法用于重建方法参数的文本:
| 1. | 参数按其标识符值的顺序重新排序。 |
| 2. | 指定为[in]和[out]的参数将被组合为单个参数。 |
要求
客户 |
需要Windows Vista,Windows XP,Windows 2000 Professional,Windows NT Workstation 4.0 SP4及更高版本,Windows Me,Windows 98或Windows 95。 |
服务器 |
需要Windows Server 2008,Windows Server 2003,Windows 2000 Server或Windows NT Server 4.0 SP4及更高版本。 |
头 |
在Wbemcli.inc中声明。 |
DLL |
需要Cimwin32.dll。 需要Esscli.dll。 需要Evntrprv.dll。 需要Fastprox.dll。 需要Framedyn.dll。 需要Krnlprov.dll。 需要Ncprov.dll。 需要Wbemcore.dll。 需要Wbemess.dll。 需要Wmipiprt.dll。 |


