勇芳软件工作室.汉化:  Windows Management Instrumentation > COM API for WMI > Interfaces > IWbemClassObject >

GetObjectText Method

Previous pageReturn to chapter overviewNext page

描述

 

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。