SWbemServices. AssociatorsOf 方法

SWbemServices物件的 AssociatorsOf 方法會傳回物件的集合, (類別或實例) 稱為與指定物件相關聯的端點。 這個方法會執行 WQL 查詢 ASSOCIATORS OF 所執行的相同功能。

依預設,會在 [半同步模式] 中呼叫這個方法。 如需詳細資訊,請參閱 呼叫方法

如需此語法的說明,請參閱 腳本 API 的檔慣例

語法

objWbemObjectSet = .AssociatorsOf( _
  ByVal strObjectPath, _
  [ ByVal strAssocClass ], _
  [ ByVal strResultClass ], _
  [ ByVal strResultRole ], _
  [ ByVal strRole ], _
  [ ByVal bClassesOnly ], _
  [ ByVal bSchemaOnly ], _
  [ ByVal strRequiredAssocQualifier ], _
  [ ByVal strRequiredQualifier ], _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ] _
)

參數

strObjectPath

必要。 字串,包含來源類別或實例的物件路徑。 如需詳細資訊,請參閱 描述 WMI 物件的位置

strAssocClass [選]

包含關聯類別的字串。 如果有指定,這個參數表示傳回的端點必須透過指定的關聯類別或衍生自這個關聯類別的類別,與來源產生關聯。

strResultClass [選]

包含類別名稱的字串。 如果有指定,此選擇性參數表示傳回的端點必須屬於或衍生自此參數中指定的類別。

strResultRole [選]

包含屬性名稱的字串。 如果有指定,這個參數表示傳回的端點必須在其與來源物件的關聯中扮演特定的角色。 角色是由指定之屬性的名稱所定義 (必須是關聯) 的參考屬性。

strRole [選]

包含屬性名稱的字串。 如果有指定,這個參數會指出傳回的端點必須參與來源物件的關聯,其中來源物件會扮演特定的角色。 角色是由指定之屬性的名稱所定義 (必須是關聯) 的參考屬性。

bClassesOnly [選]

布林值,指出是否應該傳回類別名稱的清單,而不是類別的實際實例。 這些是端點實例所屬的類別。 此參數的預設值為 FALSE

bSchemaOnly [選]

指出查詢是否適用于架構而非資料的布林值。 此參數的預設值為 FALSE。 如果 strObjectPath 參數指定類別的物件路徑,它只能設定為 TRUE 。 當設為 TRUE 時,傳回的端點集會代表與架構中的來源類別適當相關聯的類別。

strRequiredAssocQualifier [選]

包含辨識符號名稱的字串。 如果有指定,這個參數會指出傳回的端點必須透過包含指定限定詞的關聯類別,與來源物件相關聯。

strRequiredQualifier [選]

包含辨識符號名稱的字串。 如果有指定,這個參數會指出傳回的端點必須包含指定的限定詞。

iFlags [選]

指定運算其他旗標的整數。 這個參數的預設值是 wbemFlagReturnImmediately,它會以半同步模式呼叫方法。 此參數可接受下列值。

wbemFlagForwardOnly * * * (32 (0x20) )

使順向列舉值傳回。 順向列舉值的速度通常會比傳統列舉值更快,且使用的記憶體較少,但不允許呼叫 SWbemObject。 _

wbemFlagBidirectional * * * (0 (0x0) )

讓 WMI 保留列舉物件的指標,直到用戶端釋放列舉值為止。

wbemFlagReturnImmediately * * * (16 (0x10) )

導致呼叫立即返回。

wbemFlagReturnWhenComplete * * * (0 (0x0) )

導致此呼叫封鎖,直到查詢完成為止。 此旗標會以同步模式呼叫方法。

wbemFlagUseAmendedQualifiers * * * (131072 (0x20000) )

導致 WMI 傳回類別修訂資料以及基類定義。 如需詳細資訊,請參閱 當地語系化 WMI 類別資訊

objwbemNamedValueSet [選]

一般而言,這是未定義的。 否則,這會是 SWbemNamedValueSet 物件,其元素代表服務要求的提供者所能使用的內容資訊。 支援或需要這類資訊的提供者,必須記錄已辨識的值名稱、值的資料類型、允許的值,以及語義。

傳回值

如果呼叫成功,則會傳回 swbemobjectset 搭配使用 物件。

錯誤碼

AssociatorsOf 方法完成後, Err 物件可能會包含下列清單中的其中一個錯誤碼。

注意

具有零個元素的傳回集合不是錯誤。

wbemErrAccessDenied -2147749891 (0x80041003)

目前的使用者沒有許可權可查看呼叫所傳回的一或多個類別。

wbemErrFailed -2147749889 (0x80041001)

未指定的錯誤。

wbemErrInvalidParameter -2147749896 (0x80041008)

指定的參數無效。

wbemErrOutOfMemory -2147749894 (0x80041006)

記憶體不足,無法完成操作。

wbemErrNotFound -2147749890 (0x80041002)

找不到要求的專案。

備註

方法會透過一或多個關聯類別,取得與指定之資源相關聯之 managed 資源的實例。 您會提供原始端點的物件路徑,而 AssociatorsOf 會傳回相對端點的 managed 資源。 AssociatorsOf 方法會執行 WQL 查詢 ASSOCIATORS OF 所執行的相同功能。

如需 WQL 查詢、來源實例和端點 ASSOCIATORS OF 的詳細資訊,請參閱 語句 associators of

規格需求

需求
最低支援的用戶端
Windows Vista
最低支援的伺服器
Windows Server 2008
標頭
>Wbemdisp.tlb。h
類型程式庫
>Wbemdisp.tlb .tlb
DLL
Wbemdisp.dll
CLSID
CLSID _ SWbemServices
IID
IID _ ISWbemServices

另請參閱

SWbemServices

SWbemObject. Associators of_

SWbemObject. AssociatorsAsync_

SWbemServices. AssociatorsOfAsync

SWbemObject 參考_

SWbemServices. ReferencesTo