IWbemServices：:D eleteInstanceAsync 方法 (wbemcli.h)

  • 發行項

IWbemServices：:D eleteInstanceAsync方法會非同步刪除目前命名空間中現有類別的實例。 作業的確認或失敗會透過呼叫端實作的 IWbemObjectSink 介面來報告。

語法

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

參數

[in] strObjectPath

包含要刪除之物件之物件路徑的有效BSTR。

[in] lFlags

WBEM_FLAG_SEND_STATUS 向 Windows 管理註冊要求，以透過用戶端的 IWbemObjectSink：：SetStatus實作接收中繼狀態報表。 提供者實作必須支援中繼狀態報表，此旗標才能變更行為。 請注意，此處無法使用 WBEM_FLAG_USE_AMENDED_QUALIFIERS 旗標。

[in] pCtx

通常 為 Null。 否則，這是 IWbemCoNtext 物件的指標，可由刪除實例的提供者使用。 內容物件中的值必須在有問題的提供者檔中指定。

[in] pResponseHandler

呼叫端 實作 IWbemObjectSink的指標。 此處理程式會透過 SetStatus 方法接收刪除作業的狀態。 如果傳回任何錯誤碼，則不會使用提供的 IWbemObjectSink 指標。 如果 傳回WBEM_S_NO_ERROR ，則會呼叫使用者的 IWbemObjectSink 實作來指出作業的結果。 如果WBEM_S_NO_ERROR傳回，Windows 管理只會在指標上呼叫AddRef。 如果錯誤碼傳回，則參考計數會與輸入時相同。 如需詳細資訊，請參閱 呼叫方法。

傳回值

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

失敗時，您可以從 COM 函式 GetErrorInfo取得任何可用的資訊。

如果 DeleteInstanceAsync 傳回 WBEM_S_NO_ERROR，WMI 會等候回應處理常式 之 SetStatus 方法的結果。 WMI 會在本機連線上無限期等候，或直到遠端連線逾時為止。

其他錯誤狀況會以非同步方式回報給 pResponseHandler 參數所提供的物件接收。

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

注意 呼叫 DeleteInstanceAsync 的用戶端必須一律預期會使用其 IWbemObjectSink：：Indicate 方法回報呼叫的結果。
 
注意 當 strObjectPath 指向的實例屬於屬於類別階層成員的類別時， DeleteInstanceAsync 的成功取決於最上層的非抽象提供者。 如需判斷此作業成功之相關相依性的詳細說明，請參閱 IWbemServices：:D eleteInstance中的。
 

備註

執行個體提供者可以使用DeleteInstanceAsync的傳回碼，或透過pResponseHandler呼叫SetStatus來報告成功或失敗。 如果傳送至 SetStatus，則會優先透過 pResponseHandler 傳送至接收的傳回碼。 由於回呼可能不會在用戶端所需的相同驗證層級傳回，因此建議您使用半同步而非非同步通訊。 如果您需要非同步通訊，請參閱 呼叫方法。

如需以半同步方式使用方法的詳細資訊，請參閱 IWbemServices：:D eleteInstance 和 呼叫方法。

規格需求

   
最低支援的用戶端 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 eleteInstance