SWbemObject.Instances_ 方法

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

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

语法

objWbemObjectSet = .Instances_( _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ] _
)

iFlags [in, optional]: 决定调用行为的整数。此参数可以接受以下值。
wbemFlagForwardOnly (32 (0x20)): 导致返回只进枚举器。通常，相较于传统枚举器，只进枚举器快得多并且使用的内存更少，但它们不允许调用 SWbemObject.Clone_。
wbemFlagBidirectional (0 (0x0)): 使 WMI 保留指向枚举对象的指针，直到客户端释放枚举器。
wbemFlagReturnImmediately (16 (0x10)): 此参数的默认值。此标志会导致调用立即返回。
wbemFlagReturnWhenComplete (0 (0x0)): 使此调用被阻止，直到查询完成。
wbemQueryFlagShallow (1 (0x1)): 强制枚举只包含指定父类的直系子类。
wbemQueryFlagDeep (0 (0x0)): 此参数的默认值。此值强制枚举包含层次结构中的所有类。
wbemFlagUseAmendedQualifiers (131072 (0x20000)): 使 WMI 返回类修改数据以及基类定义。

objwbemNamedValueSet [in, optional]

通常，此参数未定义。如果已定义，此参数是一个 SWbemNamedValueSet 对象，其元素表示可供提供请求服务的提供程序使用的上下文信息。支持或需要此类信息的提供程序必须记录已识别的值名称、值数据类型、允许的值和语义。

如果方法成功，则返回 SWbemObjectSet 对象。

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

wbemErrAccessDenied - 2147749891 (0x80041003): 当前用户无权查看指定类的实例。
wbemErrFailed - 2147749889 (0x80041001): 发生了未指定的错误。
wbemErrInvalidClass - 2147749904 (0x80041010): 指定的类无效。
wbemErrInvalidParameter - 2147749896 (0x80041008): 指定的参数无效。
wbemErrOutOfMemory - 2147749894 (0x80041006): 内存不足，无法完成此操作。

Instances_ 方法仅适用于类对象。返回的集合具有零个元素并非错误。此方法的默认行为是半同步的，因为 IFlags 的默认值为 wbemFlagReturnImmediately。