SWbemServices. DeleteAsync 方法

SWbemServices物件的 DeleteAsync 方法會刪除物件路徑中指定的類別或實例。 DeleteAsync 的呼叫會立即傳回,而結果和狀態會透過傳遞至 objWbemSink 中指定之接收的事件傳回給呼叫端。 如需建立接收的詳細資訊,請參閱 接收 WMI 事件。 您只能刪除您所連接的命名空間中的物件。

如果動態提供者提供類別或實例,則有時無法刪除此物件,除非提供者支援類別或實例的刪除。

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

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

語法

SWbemServices.DeleteAsync( _
  [ ByVal ObjWbemSink ], _
  ByVal strObjectPath, _
  [ ByVal iFlags ], _
  [ ByVal objWbemNamedValueSet ], _
  [ ByVal objWbemAsyncContext ] _
)

參數

ObjWbemSink [選]

接收刪除結果的物件接收。 建立 SWbemSink 物件以接收物件。

strObjectPath

必要。 字串,包含您要刪除之物件的物件路徑。 如需詳細資訊,請參閱 描述 WMI 物件的位置

iFlags [選]

判斷是否傳回狀態更新。 此參數可接受下列值。

wbemFlagSendStatus * * * * (128 (0x80) )

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

wbemFlagDontSendStatus * * * (0 (0x0) )

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

objWbemNamedValueSet [選]

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

objWbemAsyncCoNtext [選]

SWbemNamedValueSet物件,這個物件會傳回物件接收以識別原始非同步呼叫的來源。 如果您要使用相同的物件接收進行多個非同步呼叫,請使用此參數。 若要使用此參數,請建立 SWbemNamedValueSet 物件,並使用 SWbemNamedValueSet. add 方法來新增值,以識別您正在進行的非同步呼叫。 這個 SWbemNamedValueSet 物件會傳回物件接收,而呼叫的來源可以使用 SWbemNamedValueSet. Item 方法進行解壓縮。 如需詳細資訊,請參閱 呼叫方法

傳回值

這個方法不會傳回值。 如果呼叫成功,物件接收就會收到刪除的通知。

錯誤碼

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

wbemErrFailed -2147749889 (0x80041001)

未指定的錯誤。

wbemErrInvalidParameter -2147749896 (0x80041008)

指定的參數無效。

wbemErrOutOfMemory -2147749894 (0x80041006)

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

wbemErrTransportFailure -2147749909 (0x80041015)

發生網路錯誤,導致無法正常運作。

wbemErrAccessDenied -2147749891 (0x80041003)

目前或指定的使用者名稱和密碼無效或已獲授權,無法進行連接。

wbemErrNotFound -2147749890 (0x80041002)

找不到要求的專案。

備註

此呼叫會立即傳回。 刪除作業的狀態會透過傳遞給 objWbemSink 中所指定接收器的回呼傳回給呼叫者。 您可以在 objWbemSink 的執行中執行最終處理。OnCompleted 事件。

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

規格需求

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

另請參閱

SWbemServices

SWbemObjectPath