SWbemObject. ReferencesAsync _ 方法

SWbemObjectReferencesAsync _ 方法會提供參考目前物件的所有關聯類別或實例的集合。 這個方法會執行查詢的 WQL 參考 所執行的相同函數。

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

語法

SWbemObject.ReferencesAsync_( _
  ByVal objWbemSink, _
  [ ByVal strResultClass ], _
  [ ByVal strRole ], _
  [ ByVal bClassesOnly ], _
  [ ByVal bSchemaOnly ], _
  [ ByVal strRequiredQualifier ], _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ], _
  [ ByVal objWbemAsyncContext ] _
)

參數

objWbemSink [在]

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

strResultClass [在中,選擇性]

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

strRole [在中,選擇性]

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

bClassesOnly [在中,選擇性]

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

bSchemaOnly [在中,選擇性]

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

strRequiredQualifier [在中,選擇性]

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

iFlags [在中,選擇性]

指定作業其他旗標的整數。 此參數可接受下列值。

wbemFlagSendStatus * * * * (128 (0x80) )

導致非同步呼叫將狀態更新傳送至物件接收的 SWbemSink. 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 事件。

錯誤碼

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

wbemErrAccessDenied -2147749891 (0x80041003)

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

wbemErrFailed -2147749889 (0x80041001)

未指定的錯誤。

wbemErrInvalidParameter -2147749896 (0x80041008)

指定的參數無效。

wbemErrOutOfMemory -2147749894 (0x80041006)

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

備註

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

非同步回呼可讓未經驗證的使用者提供資料給接收。 這會對您的腳本和應用程式帶來安全性風險。 若要消除風險,請使用兩個同步通訊或同步通訊。 如需詳細資訊,請參閱 呼叫方法

如需相關 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. Associators of_

SWbemServices. AssociatorsOf

SWbemServices. ReferencesTo

SWbemServices. ReferencesToAsync