SWbemObjectEx.GetText_ 方法

SWbemObjectEx 对象的 GetText_ 方法返回对象或实例的 XML 表示形式。 文本文件采用指定的 XML 格式，如 WbemObjectTextFormatEnum 中所示。

有关此语法的说明，请参阅脚本 API 的文档约定。

语法

strObj = .GetText_( _
  ByVal iTextFormat, _
  [ ByVal iFlags ], _
  [ ByVal objWbemNamedValueSet ] _
)

parameters

iTextFormat [in]

必需。 WbemObjectTextFormatEnum 中的值，该值指定生成的 XML 格式。

iFlags [in, optional]

保留的操作标志。 默认值为 0（零）。

objWbemNamedValueSet [in, optional]

设置操作上下文的 SWbemNamedValueSet 对象。 默认值为 NULL。 有关允许的名称/值对的详细信息，请参阅下面的备注。

返回值

此方法没有返回值。

错误代码

GetText_ 方法完成后，Err 对象可能包含以下列表中的错误代码之一。

wbemErrFailed - 2147749889 (0x80041001)

错误。

wbemErrNotFound - 2147749890 (0x80041002)

找不到请求的格式。

wbemErrInvalidParameter - 2147749896 (0x80041008)

调用的参数之一不正确。

wbemErrCriticalError - 2147749898 (0x8004100A)

发生了严重的意外内部错误。 请向 Microsoft 技术支持部门报告此错误。

备注

构造 SWbemNamedValueSet 时，只允许使用以下名称/值对。

名称	值
LocalOnly	VT_BOOL 如果为 TRUE，则生成的 XML 中只存在本地定义的属性和方法。 默认值为 FALSE。
IncludeQualifiers	VT_BOOL 如果 TRUE，则生成的 XML 中包含类、实例、属性和方法的限定符。 默认值为 FALSE。
PathLevel	VT_I4 默认值为 0（零）。 可能的值包括： 0：根据 <对象是类还是实例创建 CLASS> 或 <INSTANCE> 元素。 1：值 <。生成 NAMEDOBJECT> 元素。 2：值 >。生成 OBJECTWITHLOCALPATH> 元素。 3：值 >。生成 OBJECTWITHPATH> 元素。
ExcludeSystemProperties	VT-BOOL 如果 为 TRUE，则系统属性（如 __NAMESPACE）将从输出中排除。
IncludeClassOrigin	VT_BOOL 如果为 TRUE，则对 PROPERTY> 和 >METHOD> 元素设置>类原点特性。 默认值为 FALSE。

有关创建 SWbemNamedValueSet 的详细信息，请参阅 SWbemNamedValueSet.Add。

示例

以下脚本演示如何获取 Win32_Bios 类定义的 XML 表示形式。 通过指定 Win32_Bios 的特定实例，可获取该对象的 XML 格式数据。

' Connect to the default namespace (root\cimv2) with the default
' impersonation level ("impersonate") and obtain a Win32_Bios class
' object.
Set obj = GetObject("winmgmts:win32_bios")

' Use the value for the desired XML CIM DTD format. 
XMLDtd = 1
Text = obj.GetText_(XMLDtd)
wscript.echo Text

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
标头	Wbemdisp.h
类型库	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemObjectEx
IID	IID_ISWbemObjectEx