描述
SWbemServices对象的AssociatorsOf方法返回与指定对象关联的称为端点的对象(类或实例)的集合。此方法执行与WQL查询的ASSOCIATORS执行的功能相同的功能。
默认情况下,该方法在半同步模式下调用。有关详细信息,请参阅调用方法.
PowerBASIC 语法
METHOD AssociatorsOf ( _ BYVAL strObjectPath AS WSTRING, _ OPTIONAL BYVAL strAssocClass AS WSTRING, _ OPTIONAL BYVAL strResultClass AS WSTRING, _ OPTIONAL BYVAL strResultRole AS WSTRING, _ OPTIONAL BYVAL strRole AS WSTRING, _ OPTIONAL BYVAL bClassesOnly AS INTEGER, _ OPTIONAL BYVAL bSchemaOnly AS INTEGER, _ OPTIONAL BYVAL strRequiredAssocQualifier AS WSTRING, _ OPTIONAL BYVAL strRequiredQualifier AS WSTRING, _ OPTIONAL BYVAL iFlags AS LONG, _ OPTIONAL BYVAL objWbemNamedValueSet AS IDispatch _ ) AS ISWbemObjectSet |
参数
strObjectPath
需要。包含源类或实例的对象路径的字符串。有关详细信息,请参阅描述WMI对象的位置.
strAssocClass
包含关联类的字符串。如果指定,则此参数指示返回的端点必须通过指定的关联类或从此关联类派生的类与源关联。
strResultClass
包含类名的字符串。如果指定,则此可选参数指示返回的端点必须属于或从此参数中指定的类派生。
strResultRole
包含属性名称的字符串。如果指定,则该参数指示返回的端点必须在与源对象的关联中发挥特定的作用。角色由关联的指定属性(必须是引用属性)的名称定义。
strRole
包含属性名称的字符串。如果指定,则该参数指示返回的端点必须参与与源对象扮演特定角色的源对象的关联。角色由关联的指定属性(必须是引用属性)的名称定义。
bClassesOnly
指示是否应返回类名称列表的布尔值,而不是类的实际实例。这些是端点实例所属的类。该参数的默认值为FALSE。
bSchemaOnly
指示查询是应用于模式而不是数据的布尔值。该参数的默认值为FALSE。如果strObjectPath参数指定类的对象路径,则只能设置为TRUE。设置为TRUE时,返回的端点集合表示与模式中的源类适当关联的类。
strRequiredAssocQualifier
包含限定符名称的字符串。如果指定,则该参数指示返回的端点必须通过包含指定限定符的关联类与源对象相关联。
strRequiredQualifier
包含限定符名称的字符串。如果指定,则此参数指示返回的端点必须包含指定的限定符。
iFlags
指定操作的附加标志的整数。此参数的默认值为wbemFlagReturnImmediately,它在半同步模式下调用该方法。此参数可以接受以下值。
值 |
含义 |
wbemFlagForwardOnly 32 &H20 |
导致只返回枚举器。前向枚举器通常比传统枚举器更快,使用更少的内存,但不允许调用SWbemObject.Clone_. |
wbemFlagBidirectional 0 &H0 |
导致WMI保留枚举对象的指针,直到客户端释放枚举器。 |
wbemFlagReturnImmediately 16 &H10 |
使呼叫立即返回。 |
wbemFlagReturnWhenComplete 0 &H0 |
导致此调用阻止,直到查询完成。该标志以同步方式调用该方法。 |
wbemFlagUseAmendedQualifiers 131072 &H20000 |
导致WMI与基类定义一起返回类修改数据。有关详细信息,请参阅本地化WMI类信息. |
objWbemNamedValueSet
通常,这是未定义的。否则,这是一个SWbemNamedValueSet对象,其元素表示正在为请求提供服务的提供者可以使用的上下文信息。支持或要求此类信息的提供者必须记录识别的值名称,值的数据类型,允许的值和语义。
返回值
如果呼叫成功,则返回SWbemObjectSet对象。
OBJRESULT
错误(名称/十进制/十六进制) |
含义 |
wbemErrAccessDenied -2147217405 &H80041003 |
当前用户没有权限查看通话返回的一个或多个类。 |
wbemErrFailed -2147217407 &H80041001 |
未指定错误 |
wbemErrInvalidParameter -2147217400 &H80041008 |
指定了无效参数。 |
wbemErrOutOfMemory -2147217402 &H80041006 |
没有足够的内存来完成操作。 |
wbemErrNotFound -2147217406 &H80041002 |
未找到请求的项目。 |
备注
有关WQL查询,源实例和端点的ASSOCIATORS的更多信息,请参阅声明协调人.
要求
客户 |
需要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。 |