ISWbemSink::Cancel 方法
SWbemSink 对象的 Cancel 方法将取消与此对象接收器关联的所有未完成的异步操作。
有关此语法的说明,请参阅脚本 API 的文档约定。
语法
SWbemSink.Cancel()
parameters
此方法没有任何参数。
返回值
此方法不返回值。
错误代码
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 |