SWbemServices.InstancesOfAsync 方法
SWbemServices 物件的 InstancesOfAsync 方法 會根據使用者指定的準則擷取指定類別的實例。
方法會在非同步模式中呼叫。 如需詳細資訊，請參閱 呼叫方法 。
如需語法說明，請參閱 腳本 API 的檔慣例。
語法
SWbemServices.InstancesOfAsync( _
ByVal ObjWbemSink, _
ByVal strClass, _
[ ByVal iFlags ], _
[ ByVal objWbemNamedValueSet ], _
[ ByVal objWbemAsyncContext ] _
)
參數
-
ObjWbemSink
-
非同步接收實例的物件接收。 建立 SWbemSink 物件以接收物件。
-
strClass
-
必要。 字串，其中包含所要實例的 類別名稱。 此參數不可以是空白的。
-
iFlags [選擇性]
-
判斷呼叫列舉的深度，以及呼叫是否立即傳回。 此參數可以接受下列值。
-
wbemQueryFlagShallow （1 （0x1））
-
強制列舉只包含指定父類別的直接子類別。
-
wbemQueryFlagDeep （0 （0x0））
-
此參數的預設值。 這個值會強制列舉包含階層中的所有類別。
-
wbemFlagSendStatus （128 （0x80））
-
導致非同步呼叫將狀態更新傳送至 物件接收的 OnProgress 事件處理常式。
-
wbemFlagDontSendStatus （0 （0x0））
-
防止非同步呼叫將狀態更新傳送至物件接收的 OnProgress 事件處理常式。
-
wbemFlagUseAmendedQualifiers （131072 （0x20000））
-
導致 WMI 使用基類定義傳回類別增修資料。 如需詳細資訊，請參閱 當地語系化 WMI 類別資訊 。
objWbemNamedValueSet [選擇性]
一般而言，這是未定義的。 否則，這是 SWbemNamedValueSet 物件，其專案代表服務要求的提供者可以使用的內容資訊。 支援或需要內容資訊的提供者必須記載可辨識的值名稱、值的資料類型、允許的值和語意。
objWbemAsyncCoNtext [選擇性]
傳 回物件接收以識別原始非同步呼叫來源的 SWbemNamedValueSet 物件。 如果您使用相同的物件接收進行多個非同步呼叫，請使用此參數。 若要使用此參數，請建立 SWbemNamedValueSet 物件，並使用 SWbemNamedValueSet.Add 方法來新增值，以識別您進行之非同步呼叫。 這個 SWbemNamedValueSet 物件會傳回至物件接收，而且可以使用 SWbemNamedValueSet.Item 方法擷取 呼叫的來源。
傳回值
這個方法不會傳回值。 如果成功，接收會收到每個實例的 OnObjectReady 事件。 在最後一個 實例之後，物件接收會收到 OnCompleted 事件。
錯誤碼
在 InstancesOfAsync 方法完成 時， Err 物件可能會包含下列清單中的其中一個錯誤碼。
-
wbemErrAccessDenied - 2147749891 （0x80041003）
-
目前使用者沒有檢視指定類別實例的許可權。
-
wbemErrFailed - 2147749889 （0x80041001）
-
發生未指定的錯誤。
-
wbemErrInvalidClass - 2147749904 （0x80041010）
-
指定的類別無效。
-
wbemErrInvalidParameter - 2147749896 （0x80041008）
-
指定的參數無效。
-
wbemErrOutOfMemory - 2147749894 （0x80041006）
-
記憶體不足，無法完成作業。
備註
此呼叫會立即傳回。 要求的物件和狀態會透過傳遞至 objWbemSink 中所指定接收的 回呼傳回給呼叫端。 若要在傳回時處理每個物件，請建立 objWbemSink 。 OnObjectReady 事件副程式。 傳回所有物件之後，您可以在 objWbemSink 的 實作中執行最終處理。 OnCompleted 事件。
非同步回呼可讓未經驗證的使用者將資料提供給接收。 這對您的腳本和應用程式構成安全性風險。 若要消除風險，請參閱 在非同步呼叫上設定安全性
InstancesOfAsync 方法只適用于類別物件。 傳回的列舉值沒有零 （0） 個元素的錯誤。
需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows Vista |
| 最低支援的伺服器 |
Windows Server 2008 |
| 標題 |
|
| 類型程式庫 |
|
| DLL |
|
| CLSID |
CLSID_SWbemServices |
| IID |
IID_ISWbemServices |