SWbemObject. Associators of _ 方法

SWbemObject物件的 associators of _ 方法會傳回與目前物件相關聯) (類別或實例的集合。 這些傳回的物件稱為端點。 這個方法會執行 WQL 查詢 ASSOCIATORS OF 所執行的相同功能。

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

語法

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

參數

strAssocClass [在中,選擇性]

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

strResultClass [在中,選擇性]

包含類別名稱的字串。 如果有指定,這個參數會指出傳回的端點必須屬於或衍生自此參數中指定的類別。

strResultRole [在中,選擇性]

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

strRole [在中,選擇性]

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

bClassesOnly [在中,選擇性]

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

bSchemaOnly [在中,選擇性]

這是布林值,指出查詢是否適用于架構,而不是資料。 此參數的預設值為 FALSE。 如果叫用此方法的物件為類別,則只能設定為 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 搭配使用 物件。

錯誤碼

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

wbemErrAccessDenied -2147749891 (0x80041003)

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

wbemErrFailed -2147749889 (0x80041001)

未指定的錯誤。

wbemErrInvalidParameter -2147749896 (0x80041008)

指定的參數無效。

wbemErrOutOfMemory -2147749894

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

備註

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

規格需求

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

另請參閱

SWbemObject

SWbemObject 參考_

SWbemServices. AssociatorsOf

SWbemServices. ReferencesTo