SWbemServices. ReferencesTo 方法

SWbemServices物件的 ReferencesTo 方法會傳回參考特定來源類別或實例之所有關聯類別或實例的集合。 這個方法會執行 WQL 查詢 參考 所執行的相同函數。

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

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

語法

objWbemObjectSet = .ReferencesTo( _
  ByVal strObjectPath, _
  [ ByVal strResultClass ], _
  [ ByVal strRole ], _
  [ ByVal bClassesOnly ], _
  [ ByVal bSchemaOnly ], _
  [ ByVal strRequiredQualifier ], _
  [ ByVal iFlags ], _
  [ ByVal objWbemNamedValueSet ] _
)

參數

strObjectPath

必要。 字串,包含此方法之來源的物件路徑。 如需詳細資訊,請參閱 描述 WMI 物件的位置

strResultClass [選]

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

strRole [選]

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

bClassesOnly [選]

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

bSchemaOnly [選]

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

strRequiredQualifier [選]

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

iFlags [選]

指定運算其他旗標的整數。 這個參數的預設值是 wbemFlagReturnImmediately,它會指示立即傳回呼叫,而不是等到查詢完成為止。 此參數可接受下列值。

wbemFlagForwardOnly * * * (32 (0x20) )

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

wbemFlagBidirectional * * * (0 (0x0) )

造成 Windows Management Instrumentation (WMI) 保留列舉物件的指標,直到用戶端釋放列舉值為止。

wbemFlagReturnImmediately * * * (16 (0x10) )

導致呼叫立即返回。

wbemFlagReturnWhenComplete * * * (0 (0x0) )

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

wbemFlagUseAmendedQualifiers * * * (131072 (0x20000) )

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

objWbemNamedValueSet [選]

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

傳回值

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

錯誤碼

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

注意

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

wbemErrAccessDenied -2147749891 (0x80041003)

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

wbemErrFailed -2147749889 (0x80041001)

未指定的錯誤。

wbemErrInvalidParameter -2147749896 (0x80041008)

指定的參數無效。

wbemErrOutOfMemory -2147749894 (0x80041006)

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

wbemFlagUseAmendedQualifiers -131072 (0x20000)

讓 WMI 以基類定義傳回類別修訂資料。

備註

如需相關 WQL 查詢、來源實例和關聯物件之參考的詳細資訊,請參閱 語句 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 參考_

SWbemServices. AssociatorsOf