SWbemServices.ReferencesToAsync 方法

SWbemServices物件的ReferencesToAsync方法會傳回參考特定來源類別或實例的所有關聯類別或實例。 這個方法會執行 REFERENCES OF WQL 查詢執行的相同函式。

如需非同步模式的詳細資訊，請參閱 呼叫方法。

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

語法

SWbemServices.ReferencesToAsync( _
  ByVal ObjWbemSink, _
  ByVal strObjectPath, _
  [ ByVal strResultClass ], _
  [ ByVal strRole ], _
  [ ByVal bClassesOnly ], _
  [ ByVal bSchemaOnly ], _
  [ ByVal strRequiredQualifier ], _
  [ ByVal iFlags ], _
  [ ByVal objWbemNamedValueSet ], _
  [ ByVal objWbemAsyncContext ] _
)

參數

ObjWbemSink

必要。 以非同步方式接收物件的物件接收。 建立 SWbemSink 物件以接收物件。

strObjectPath

必要。 包含這個方法之來源之物件路徑的字串。 如需詳細資訊，請參閱 當地語系化 WMI 類別資訊。

strResultClass [選擇性]

包含類別名稱的字串。 如果指定，此參數表示傳回的關聯物件必須屬於或衍生自此參數中指定的類別。

strRole [選擇性]

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

bClassesOnly [選擇性]

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

bSchemaOnly [選擇性]

布林值，指出查詢是否套用至架構，而不是資料。 此參數的預設值為 FALSE。 只有在strObjectPath參數指定類別的物件路徑時，才能將它設定為TRUE。 當設定為 TRUE時，傳回的端點集合代表與架構中來源類別相關聯的類別。

strRequiredQualifier [選擇性]

包含限定詞名稱的字串。 如果指定，此參數表示傳回的關聯物件必須包含指定的限定詞。

iFlags [選擇性]

整數，指定作業的其他旗標。 此參數的預設值為 wbemFlagBidirectional。 此參數可以接受下列值。

wbemFlagSendStatus (128 (0x80) )

導致非同步呼叫將狀態更新傳送至物件接收的 OnProgress 事件處理常式。

wbemFlagDontSendStatus (0 (0x0) )

防止非同步呼叫將狀態更新傳送至物件接收的 OnProgress 事件處理常式。

wbemFlagUseAmendedQualifiers (131072 (0x20000) )

讓 Windows Management Instrumentation (WMI) 傳回類別增修條款資料以及基類定義。 如需詳細資訊，請參閱 當地語系化 WMI 類別資訊。

objWbemNamedValueSet [選擇性]

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

objWbemAsyncCoNtext [選擇性]

這是 SWbemNamedValueSet 物件，會傳回物件接收，以識別原始非同步呼叫的來源。 使用此參數，使用相同的物件接收進行多個非同步呼叫。 若要使用此參數，請建立 SWbemNamedValueSet 物件，並使用 SWbemNamedValueSet.Add 方法來新增可識別您進行之非同步呼叫的值。 這個 SWbemNamedValueSet 物件會傳回至物件接收，而且可以使用 SWbemNamedValueSet.Item 方法擷取呼叫的來源。 如需詳細資訊，請參閱 呼叫方法。

傳回值

這個方法不會傳回值。 如果成功，接收就會在每個實例收到 OnObjectReady 事件。 最後一個實例之後，物件接收會收到 OnCompleted 事件。

錯誤碼

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

注意

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

wbemErrAccessDenied - 2147749891 (0x80041003)

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

wbemErrFailed - 2147749889 (0x80041001)

未指定的錯誤。

wbemErrInvalidParameter - 2147749896 (0x80041008)

指定了不正確參數。

wbemErrOutOfMemory - 2147749894 (0x80041006)

記憶體不足，無法完成作業。

備註

此呼叫會立即傳回。 要求的物件和狀態會透過傳遞至 objWbemSink中指定的接收回呼傳回給呼叫端。 若要在傳回時處理每個物件，請建立 objWbemSink。OnObjectReady 事件副程式。 傳回所有物件之後，您可以在 objWbemSink實作中執行最終處理。OnCompleted 事件。

非同步回呼可讓未驗證的使用者將資料提供給接收。 這對您的腳本和應用程式造成安全性風險。 若要消除風險，請參閱 在非同步呼叫上設定安全性。

規格需求

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

另請參閱

SWbemServices

SWbemObject.Associators_

SWbemObject.References_

SWbemServices.AssociatorsOf