描述
SWbemServices对象的InstancesOf方法创建一个枚举器，它根据用户指定的选择条件返回指定类的实例。该方法实现了一个简单的查询。更复杂的查询可能需要使用SWbemServices.ExecQuery.
该方法在半同步模式下被调用。有关详细信息，请参阅调用方法.
PowerBASIC 语法
METHOD InstancesOf ( _ BYVAL strClass AS WSTRING, _ OPTIONAL BYVAL iFlags AS LONG, _ OPTIONAL BYVAL objWbemNamedValueSet AS IDispatch _ ) AS ISWbemObjectSet |
参数
strClass
需要。包含需要实例的类的名称的字符串。此参数不能为空。
iFlags
此参数确定调用枚举的深度以及此调用是否立即返回。此参数的默认值为wbemFlagReturnImmediately.此参数可以接受以下值。
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 |
没有足够的内存来完成操作。 |
备注
InstancesOf方法仅适用于类对象。
要求
客户 |
需要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。 |