SWbemServices.AssociatorsOf 方法

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

此方法預設會以半同步模式呼叫。 如需詳細資訊，請參閱 呼叫方法。

如需此語法的說明，請參閱 腳本 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.Clone_。

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 方法會執行 ASSOCIATORS OF WQL 查詢執行的相同函式。

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

規格需求

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

另請參閱

SWbemServices

SWbemObject.Associators_

SWbemObject.AssociatorsAsync_

SWbemServices.AssociatorsOfAsync

SWbemObject.References_

SWbemServices.ReferencesTo