共用方式為


SWbemServices.SubclassesOfAsync 方法

SWbemServices物件的SubclassesOfAsync方法會傳回指定類別的子類別集合。 只對類別物件使用這個方法。

這個方法會在非同步模式中呼叫。 如需詳細資訊,請參閱 呼叫方法

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

語法

SWbemServices.SubclassesOfAsync( _
  ByVal ObjWbemSink, _
  [ ByVal strSuperclass ], _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ], _
  [ ByVal objWbemAsyncContext ] _
)

參數

ObjWbemSink

必要。 非同步接收子類別的物件接收。 建立 SWbemSink 物件以接收物件。

strSuperclass [選擇性]

指定父類別名稱。 列舉值中只會傳回屬於這個類別之子類別的類別。 如果此參數是空白的,而且如果 iFlagswbemQueryFlagShallow,則只會傳回最上層類別 (,也就是沒有父類別的類別) 。 如果此參數是空白的,而且 如果 iFlagswbemQueryFlagDeep,則會傳回命名空間中的所有類別。

iFlags [選擇性]

決定呼叫列舉的深度。 此參數的預設值為 wbemQueryFlagDeep。 此參數可以接受下列值。

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 事件。

錯誤碼

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

注意

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

wbemErrAccessDenied - 2147749891 (0x80041003)

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

wbemErrFailed - 2147749889 (0x80041001)

未指定的錯誤。

wbemErrInvalidClass - 2147749904 (0x80041010)

指定的類別不存在。

wbemErrInvalidParameter - 2147749896 (0x80041008)

指定了不正確參數。

wbemErrOutOfMemory - 2147749894 (0x80041006)

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

備註

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

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

規格需求

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

另請參閱

SWbemServices

SWbemObjectSet