SWbemObject.Instances_ 方法

SWbemObject物件的Instances_方法會建立列舉值，以傳回目前類別物件的實例。這個方法會實作簡單的查詢。更複雜的查詢可能需要使用 SWbemServices.ExecQuery。

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

語法

objWbemObjectSet = .Instances_( _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ] _
)

iFlags [in， optional]: 決定呼叫行為的整數。此參數可以接受下列值。
wbemFlagForwardOnly (32 (0x20) ): 導致傳回順向列舉值。順向列舉值通常比傳統列舉值快得多，而且使用較少的記憶體，但不允許呼叫 SWbemObject.Clone_。
wbemFlagBidirectional (0 (0x0) ): 讓 WMI 保留列舉物件的指標，直到用戶端釋放列舉值為止。
wbemFlagReturnImmediately (16 (0x10) ): 此參數的預設值。此旗標會導致立即傳回呼叫。
wbemFlagReturnWhenComplete ( 0 (0x0) ): 導致此呼叫封鎖，直到查詢完成為止。
wbemQueryFlagShallow (1 (0x1) ): 強制列舉只包含指定父類別的立即子類別。
wbemQueryFlagDeep (0 (0x0) ): 此參數的預設值。這個值會強制列舉在階層中包含所有類別。
wbemFlagUseAmendedQualifiers (131072 (0x20000) ): 讓 WMI 使用基類定義傳回類別增修條款資料。

objwbemNamedValueSet [in， optional]

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

如果方法成功， SWbemObjectSet 物件會傳回。

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

wbemErrAccessDenied - 2147749891 (0x80041003): 目前使用者沒有檢視指定類別實例的許可權。
wbemErrFailed - 2147749889 (0x80041001): 發生未指定的錯誤。
wbemErrInvalidClass - 2147749904 (0x80041010): 指定的類別無效。
wbemErrInvalidParameter - 2147749896 (0x80041008): 指定的參數無效。
wbemErrOutOfMemory - 2147749894 (0x80041006): 記憶體不足，無法完成作業。

Instances_方法僅適用于類別物件。傳回的集合不會有零個專案的錯誤。此方法的預設行為是半同步處理，因為預設IFlags 值 wbemFlagReturnImmediately。