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

Instances_ Method

Previous pageReturn to chapter overviewNext page

描述

 

SWbemObject对象的Instances_方法创建一个枚举器,该枚举器返回当前类对象的实例。该方法实现了一个简单的查询。更多复杂的查询可能需要使用SWbemServices.ExecQuery.

 

PowerBASIC 语法

 

METHOD Instances_ ( _

OPTIONAL BYVAL iFlags AS LONG, _

OPTIONAL BYVAL objWbemNamedValueSet AS IDispatch _

) AS ISWbemObjectSet

 

参数

 

iFlags

 

确定呼叫行为的整数。此参数可以接受以下值。

 

wbemFlagForwardOnly

32

&H20

导致只返回枚举器。前向枚举器通常比常规枚举器更快,使用更少的内存,但不允许调用SWbemObject.Clone_.

wbemFlagBidirectional

0

&H0

导致WMI保留枚举对象的指针,直到客户端释放枚举器。

wbemFlagReturnImmediately

16

&H10

此参数的默认值。该标志使呼叫立即返回。

wbemFlagReturnWhenComplete

0

&H0

导致此调用阻止,直到查询完成。

wbemQueryFlagShallow

1

&H1

强制枚举只包括指定父类的直接子类。

wbemQueryFlagDeep

0

&H0

该参数的默认值。此值强制枚举将所有类包括在层次结构中。

wbemFlagUseAmendedQualifiers

131072

&H20000

导致WMI使用基类定义返回类修改数据。

 

objwbemNamedValueSet

 

通常,这是未定义的。否则,这是一个SWbemNamedValueSet对象,其元素表示正在为请求提供服务的提供商可以使用的上下文信息。支持或要求此类信息的提供者必须记录识别的值名称,值的数据类型,允许的值和语义。

 

返回值

 

如果方法成功,则返回一个SWbemObjectSet对象。

 

OBJRESULT

 

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

含义

wbemErrAccessDenied

-2147217405

&H80041003

当前用户没有权限查看指定类的实例。

wbemErrFailed

-2147217407

&H80041001

未指定错误

wbemErrInvalidClass

-2147217392

&H80041010

指定的类无效。

wbemErrInvalidParameter

-2147217400

&H80041008

指定了无效参数。

wbemErrOutOfMemory

-2147217402

&H80041006

没有足够的内存来完成操作。

 

备注

 

Instances_方法仅适用于类对象。返回的集合不具有零元素的错误。由于默认IFlagswbemFlagReturnImmediately,此方法的默认行为是半异步的。

 

要求

 

客户

需要Windows Vista,Windows XP,Windows 2000 Professional,Windows NT Workstation 4.0 SP4及更高版本,Windows Me,Windows 98或Windows 95 OSR2及更高版本。

服务器

需要Windows Server 2008,Windows Server 2003,Windows 2000 Server或Windows NT Server 4.0 SP4及更高版本。

类型库

使用Wbemdisp.tlb。

Wbemdisp.inc。

DLL

需要Wbemdisp.dll。