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
標頭	Wbemdisp.h
Idl	Wbemdisp.idl
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemSink
IID	IID_ISWbemSink

另請參閱

SWbemSink