SWbemServices.SubclassesOfAsync 方法

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

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

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

語法

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

參數

ObjWbemSink

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

strSuperclass [選擇性]

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

iFlags [選擇性]

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

wbemQueryFlagShallow (1 (0x1) )

強制列舉只包含指定父類別的立即子類別。

wbemQueryFlagDeep (0 (0x0) )

此參數的預設值。 這個值會強制遞迴列舉衍生自指定父類別的所有子類別。 列舉中不會傳回父類別。

wbemFlagSendStatus (128 (0x80) )

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

wbemFlagDontSendStatus (0 (0x0) )

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

wbemFlagUseAmendedQualifiers (131072 (0x20000) )

讓 WMI 使用基類定義傳回類別增修條款資料。 如需詳細資訊，請參閱 當地語系化 WMI 類別資訊。

傳回值

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

錯誤碼

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

wbemErrAccessDenied - 2147749891 (0x80041003)

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

wbemErrFailed - 2147749889 (0x80041001)

未指定的錯誤。

wbemErrInvalidClass - 2147749904 (0x80041010)

指定的類別不存在。

wbemErrInvalidParameter - 2147749896 (0x80041008)

指定了不正確參數。

wbemErrOutOfMemory - 2147749894 (0x80041006)

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

備註

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

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

規格需求

另請參閱

SWbemServices

SWbemObjectSet