勇芳软件工作室.汉化:  Windows Management Instrumentation > Scripting API for WMI > Scripting API Objects > SWbemSink >

Cancel Method

Previous pageReturn to chapter overviewNext page

描述

 

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。