描述
SWbemSink对象的取消方法取消与此对象接收器关联的所有未完成的异步操作。
PowerBASIC 语法
METHOD Cancel () |
OBJRESULT
错误(名称/十进制/十六进制) |
含义 |
wbemErrFailed -2147217407 &H80041001 |
未指定错误 |
wbemErrOutOfMemory -2147217402 &H80041006 |
没有足够的内存来完成操作。 |
wbemErrTransportFailure -2147217387 &H80041015 |
出现网络错误,防止正常运行。 |
wbemErrAccessDenied -2147217405 &H80041003 |
当前或指定的用户名和密码无效或被授权进行连接。 |
备注
您不能仅取消一个异步呼叫。如果使用此对象宿的多个异步调用挂起,则此方法将使用此对象宿取消所有异步调用。与其他对象接收器关联的异步调用继续不受影响。
您不能将此接收器分配给没有以取消异步操作。您必须调用取消方法使WMI终止操作并释放相关资源。这对于冗长的异步操作(如查询)或从未完成的操作(如ExecNotificationQueryAsync)非常重要。
注意异步回调允许非验证用户向sink提供数据。这对您的脚本和应用程序造成安全隐患。为了消除风险,请使用半异步或同步通信。有关详细信息,请参阅调用方法.
以下示例显示如何取消异步调用。
objwbemsink.Cancel()
set objwbemsink = Nothing
要求
客户 |
需要Windows Vista,Windows XP,Windows 2000 Professional,Windows NT Workstation 4.0 SP4及更高版本,Windows Me,Windows 98或Windows 95 OSR2及更高版本。 |
服务器 |
需要Windows Server 2008,Windows Server 2003,Windows 2000 Server或Windows NT Server 4.0 SP4及更高版本。 |
类型库 |
使用Wbemdisp.tlb。 |
头 |
Wbemdisp.inc。 |
DLL |
需要Wbemdisp.dll。 |