SWbemObject.DeleteAsync_ 方法
SWbemObject的 DeleteAsync_方法會以非同步方式刪除目前類別或目前的實例。 如果動態提供者提供 類別或實例,除非提供者支援類別或實例刪除,否則有時無法刪除此物件。
如需此語法的說明,請參閱 腳本 API 的檔慣例。
語法
SWbemObject.DeleteAsync_( _
ByVal objWbemSink, _
[ ByVal iFlags ], _
[ ByVal objwbemNamedValueSet ], _
[ ByVal objWbemAsyncContext ] _
)
參數
-
objWbemSink [in]
-
傳回刪除作業結果的物件接收。
-
iFlags [in, optional]
-
決定呼叫行為的整數。 此參數可以接受下列值。
-
wbemFlagSendStatus (128 (0x80) )
-
導致非同步呼叫將狀態更新傳送至物件接收的 SWbemSink.OnProgress 事件處理常式。
-
wbemFlagDontSendStatus ( 0 (0x0) )
-
防止非同步呼叫將狀態更新傳送至物件接收的 OnProgress 事件處理常式。
objwbemNamedValueSet [in, optional]
此參數通常未定義。 否則,這是 SWbemNamedValueSet 物件,其元素代表服務要求的提供者可以使用的內容資訊。 支援或需要這類資訊的提供者必須記載已辨識的值名稱、值的資料類型、允許的值和語意。
objWbemAsyncCoNtext [in, optional]
這是 SWbemNamedValueSet 物件,會傳回物件接收,以識別原始非同步呼叫的來源。 如果您要使用相同的物件接收進行多個非同步呼叫,請使用此參數。 若要使用此參數,請建立 SWbemNamedValueSet 物件,並使用 SWbemNamedValueSet.Add 方法來新增值,以識別您進行的非同步呼叫。 這個 SWbemNamedValueSet 物件會傳回至物件接收,而且可以使用 SWbemNamedValueSet.Item 方法擷取呼叫的來源。 如需詳細資訊,請參閱 呼叫方法。
傳回值
這個方法不會傳回值。 如果此呼叫成功,則會透過提供的物件接收來提供刪除作業的結果。
錯誤碼
完成 DeleteAsync_ 方法之後, Err 物件可能會包含下列清單中的其中一個錯誤碼。
-
wbemErrAccessDenied - 2147749891 (0x80041003)
-
目前的內容沒有足夠的安全性許可權可刪除物件。
-
wbemErrFailed - 2147749890 (0x80041002)
-
未指定的錯誤。
-
wbemErrInvalidClass - 2147749904 (0x80041010)
-
指定的類別不存在。
-
wbemErrInvalidOperation - 2147749910 (0x80041016)
-
無法刪除物件。
-
wbemErrNotFound - 2147749890 (0x80041002)
-
物件不存在。
-
wbemErrOutOfMemory - 2147749894 (0x80041006)
-
記憶體不足,無法完成作業。
備註
此呼叫會立即傳回。 狀態會透過傳遞至 objWbemSink中指定的接收回呼傳回給呼叫端。
非同步回呼可讓未經驗證的使用者將資料提供給接收。 這對您的腳本和應用程式造成安全性風險。 若要消除風險,請使用半同步通訊或同步通訊。 如需詳細資訊,請參閱 呼叫方法。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows Vista |
最低支援的伺服器 |
Windows Server 2008 |
標頭 |
|
類型程式庫 |
|
DLL |
|
CLSID |
CLSID_SWbemObject |
IID |
IID_ISWbemObject |