ISWbemSink::Cancel 方法
SWbemSink物件的Cancel方法會取消與此物件接收相關聯的所有未完成非同步作業。
如需此語法的說明,請參閱 腳本 API 的檔慣例。
語法
SWbemSink.Cancel()
參數
這個方法沒有任何參數。
傳回值
這個方法不會傳回值。
錯誤碼
完成 Cancel方法之後,Err物件可能包含下列其中一個錯誤碼。
-
wbemErrFailed - 2147749889 (0x80041001)
-
未指定的錯誤。
-
wbemErrOutOfMemory - 2147749894 (0x80041006)
-
記憶體不足,無法完成作業。
-
wbemErrTransportFailure - 2147749909 (0x80041015)
-
發生網路錯誤,防止正常作業。
-
wbemErrAccessDenied - 2147749891 (0x80041003)
-
目前或指定的使用者名稱和密碼無效,或有權進行連線。
備註
您無法只取消一個非同步呼叫。 如果有多個非同步呼叫擱置使用這個物件接收,則這個方法會取消使用此物件接收的所有非同步呼叫。 與其他物件接收相關聯的非同步呼叫會繼續不受影響。
您無法將此接收指派給 Nothing ,以取消非同步作業。 您必須呼叫 Cancel 方法,讓 WMI 停止作業並釋放相關聯的資源。 這在冗長的非同步作業中非常重要,例如查詢或從未完成的作業,例如 ExecNotificationQueryAsync。
注意
非同步回呼可讓未驗證的使用者將資料提供給接收。 這對您的腳本和應用程式造成安全性風險。 若要消除風險,請使用半同步或同步通訊。 如需詳細資訊,請參閱 呼叫方法。
下列範例示範如何取消非同步呼叫。
objwbemsink.Cancel()
set objwbemsink= Nothing
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows Vista |
最低支援的伺服器 |
Windows Server 2008 |
標頭 |
|
Idl |
|
DLL |
|
CLSID |
CLSID_SWbemSink |
IID |
IID_ISWbemSink |