共用方式為


IWbemServices::D eleteClassAsync 方法 (wbemcli.h)

IWbemServices::D eleteClassAsync方法會從目前的命名空間中刪除指定的類別。 這個方法與 IWbemServices::D eleteClass 相同,但呼叫會立即傳回。 作業完成後,會使用 IWbemObjectSink::SetStatus 方法,以非同步方式向指定的物件接收報告確認或失敗。

語法

HRESULT DeleteClassAsync(
  [in] const BSTR      strClass,
  [in] long            lFlags,
  [in] IWbemContext    *pCtx,
  [in] IWbemObjectSink *pResponseHandler
);

參數

[in] strClass

以刪除為目標的類別名稱。

[in] lFlags

下列一或多個值有效。

WBEM_FLAG_SEND_STATUS

此旗標向 Windows 管理註冊要求,以透過用戶端的 IWbemObjectSink::SetStatus實作接收中繼狀態報表。 提供者實作必須支援中繼狀態報表,此旗標才能變更行為。

WBEM_FLAG_OWNER_UPDATE

推送提供者必須在呼叫 DeleteClassAsync 時指定此旗標,以指出此類別已變更。

[in] pCtx

通常 為 Null。 否則,這是 IWbemCoNtext 物件的指標,可由提供者刪除類別使用。 內容物件中的值必須在有問題的提供者檔中指定。 如需此參數的詳細資訊,請參閱 呼叫 WMI

[in] pResponseHandler

呼叫端實作 之 IWbemObjectSink 實作的指標。 這個處理常式會透過 IWbemObjectSink::SetStatus 方法取得刪除要求的狀態。 如果傳回任何錯誤碼,則不會使用提供的 IWbemObjectSink 指標。 如果 傳回WBEM_S_NO_ERROR ,則會呼叫使用者的 IWbemObjectSink 實作來指出作業的結果。 如果WBEM_S_NO_ERROR傳回,Windows 管理只會在指標上呼叫AddRef。 如果錯誤碼傳回,則參考計數會與輸入時相同。 如需此參數的詳細說明,請參閱 呼叫方法

傳回值

這個方法會傳回 HRESULT ,指出方法呼叫的狀態。 下列清單列出 HRESULT中包含的值。

所有其他傳回碼都會透過SetStatus方法提供給pReponseHandler參數所指定的物件接收。 錯誤狀況,例如類別不存在或使用者沒有刪除類別的許可權時,會回報給處理常式。 此方法的傳回碼中不會報告它們。

如果網路問題造成您遺失與 Windows 管理的遠端連線,也可能傳回 COM 特定的錯誤碼。

備註

如果動態執行個體提供者與 類別相關聯,則會取消註冊提供者,且不再針對該類別呼叫。 任何衍生自已刪除類別的類別也會遭到刪除,且其相關聯的提供者會變成取消註冊。 刪除類別時,也會刪除指定類別及其子類別的所有未處理靜態實例。

如果類別是由動態類別提供者提供,則刪除成功取決於該提供者是否支援類別刪除。

注意 無法刪除標準系統類別。
 
由於回呼可能不會在用戶端所需的相同驗證層級傳回,因此建議您使用半同步而非非同步通訊。 如果您需要非同步通訊,請參閱 呼叫方法

如需以半同步方式使用方法的詳細資訊,請參閱 IWbemServices::D eleteClass呼叫方法

規格需求

   
最低支援的用戶端 Windows Vista
最低支援的伺服器 Windows Server 2008
目標平台 Windows
標頭 wbemcli.h (包含 Wbemidl.h)
程式庫 Wbemuuid.lib
Dll Fastprox.dll;Esscli.dll;FrameDyn.dll;FrameDynOS.dll;Ntevt.dll;Stdprov.dll;Viewprov.dll;Wbemcomn.dll;Wbemcore.dll;Wbemess.dll;Wbemsvc.dll;Wmipicmp.dll;Wmidcprv.dll;Wmipjobj.dll;Wmiprvsd.dll

另請參閱

IWbemServices

IWbemServices::D eleteClass

擷取錯誤碼