勇芳软件工作室.汉化:  Windows Management Instrumentation > Scripting API for WMI > Scripting API Objects > SWbemObjectEx >

GetText_ Method

Previous pageReturn to chapter overviewNext page

描述

 

SWbemObjectEx对象的GetText_方法返回对象或实例的XML表示形式。文本文件格式化为WbemObjectTextFormatEnum中指定的XML格式。

 

PowerBASIC 语法

 

METHOD GetText_ ( _

BYVAL iObjectTextFormat AS LONG, _

OPTIONAL BYVAL iFlags AS LONG, _

OPTIONAL BYVAL objWbemNamedValueSet AS IDispatch _

) AS WSTRING

 

参数

 

iObjectTextFormat

 

需要。来自WbemObjectTextFormatEnum的值,用于指定生成的XML格式。

 

iFlags

 

保留操作标志。默认值为0(零)。

 

objWbemNamedValueSet

 

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

 

返回值

 

对象或实例的XML表示形式。

 

OBJRESULT

 

错误(名称/十进制/十六进制)

含义

wbemErrFailed

-2147217407

&H80041001

未指定错误

wbemErrNotFound

-2147217406

&H80041002

请求的格式未找到。

wbemErrInvalidParameter

-2147217400

&H80041008

指定了无效参数。

wbemErrCriticalError

-2147217398

&H8004100A

发生内部,关键和意外的错误。向Microsoft技术支持报告此错误。

 

示例代码

 

以下脚本显示如何获取Win32_Bios类定义的XML表示。通过指定Win32_Bios的特定实例,可以使用XML获取该对象的数据。

 

'连接到默认名称空间(root \\ cimv2)与默认

'模拟级别(“impersonate”)并获得Win32_Bios类

'对象。

设置obj = GetObject(“winmgmts:win32_bios”)

 

'使用所需的XML CIM DTD格式的值。

XMLDtd = 1

Text = obj.GetText_(XMLDtd)

wscript.echo文本

 

备注

 

构建您的SWbemNamedValueSet时,只允许使用以下名称/值对。

 

名称

LocalOnly

VT_BOOL

 

如果为TRUE,则只有本地定义的属性和方法存在于生成的XML中。默认值为FALSE。

IncludeQualifiers

VT_BOOL

 

如果为TRUE,则生成的XML中包含类,实例,属性和方法的限定符。默认值为FALSE。

PathLevel

VT-I4

 

默认值为0(零)。可能的值是:

描述

0

根据对象是类还是实例,创建<类>或<INSTANCE >元素。

1

生成<VALUE.NAMEDOBJECT >元素。

2

生成<VALUE.OBJECTWITHLOCALPATH >元素。

3

生成<VALUE.OBJECTWITHPATH >元素。

ExcludeSystemProperties

VT-BOOL

 

如果为TRUE,系统属性(如__NAMESPACE)将从输出中排除。

IncludeClassOrigin

VT_BOOL

 

如果为TRUE,则起始属性在<PROPERTY >和<METHOD >元素上设置。默认值为FALSE。

 

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

 

要求

 

客户

需要Windows Vista或Windows XP。

服务器

需要Windows Server 2008或Windows Server 2003。

类型库

使用Wbemdisp.tlb。

Wbemdisp.inc。

DLL

需要Wbemdisp.dll。