SWbemObject. InstancesAsync _ 方法

SWbemObjectInstancesAsync _ 方法會以非同步方式提供目前類別物件的實例。 這個方法會執行簡單的查詢。 更複雜的查詢可能需要使用 SWbemServices.ExecQuery

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

語法

SWbemObject.InstancesAsync_( _
  ByVal objWbemSink, _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ], _
  [ ByVal objWbemAsyncContext ] _
)

參數

objWbemSink [在]

傳回實例的物件接收。

iFlags [在中,選擇性]

判斷呼叫行為的整數。 此參數可接受下列值。

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

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

wbemFlagDontSendStatus * * * (0 (0x0) )

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

wbemFlagUseAmendedQualifiers * * * (131072 (0x20000) )

導致 WMI 傳回當地語系化的類別和屬性描述。 如需詳細資訊,請參閱 當地語系化 WMI 類別資訊

objwbemNamedValueSet [在中,選擇性]

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

objWbemAsyncCoNtext [在中,選擇性]

這是一個 SWbemNamedValueSet 物件,它會返回物件接收以識別原始非同步呼叫的來源。 如果您要使用相同的物件接收進行多個非同步呼叫,請使用此參數。 若要使用此參數,請建立 SWbemNamedValueSet 物件,並使用 SWbemNamedValueSet. add 方法來新增值,以識別您正在進行的非同步呼叫。 這個 SWbemNamedValueSet 物件會傳回物件接收,而呼叫的來源可以使用 SWbemNamedValueSet. Item 方法進行解壓縮。 如需詳細資訊,請參閱 呼叫方法

傳回值

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

錯誤碼

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

wbemErrAccessDenied -2147749891 (0x80041003)

目前的使用者沒有許可權可查看指定之類別的實例。

wbemErrFailed -2147749889 (0x80041001)

發生未指定的錯誤。

wbemErrInvalidClass -2147749904 (0x80041010)

指定的類別無效。

wbemErrInvalidParameter -2147749896 (0x80041008)

指定的參數無效。

wbemErrOutOfMemory -2147749894 (0x80041006)

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

備註

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

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

InstancesAsync _ 方法只適用于類別物件。 傳回的集合不會有零 (0) 元素,這並不是錯誤。

規格需求

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

另請參閱

SWbemObject

Swbemobjectset 搭配使用