描述

 

IWbemServices.CancelAsyncCall方法将基于最初传递给异步方法的IWbemObjectSink指针取消任何当前挂起的异步调用。未完成的IWbemObjectSink指针可以在通话或呼叫返回之后释放。方法提供者不支持CancelAsyncCall方法在一个接收器内部无法运行。这意味着只有客户端的呼叫被取消。执行提供商不会通知呼叫已被取消并运行完毕。在取消需要很长时间的方法之前，您应该考虑这一点，例如Win32_Volume类中的磁盘碎片整理和格式方法。

 

C++ 语法

 

 

PowerBASIC 语法

 

 

参数

 

pSink

 

指向客户端提供给IWbemServices的任何异步方法的IWbemObjectSink实现。

 

返回值

 

此方法返回一个HRESULT，表示方法调用的状态。下表列出了HRESULT中包含的值。

 

失败时，您可以从COM函数GetErrorInfo获取可用的信息。

 

如果网络问题导致您失去与Windows Management的远程连接，也可以返回COM特定的错误代码。

 

注意如果在WMI进程CancelAsyncCall时尚未在应用程序的接收器上调用SetStatus，则WMI将使用WBEM_E_CALL_CANCELLED作为HRESULT参数的值调用该接收器上的SetStatus.

 

时序和异步操作的性质可以影响WMI是否能够取消操作。只有冗长的查询可能在完成之前成功取消。更快的操作，如异步删除或修改，通常在WMI处理CancelAsyncCall调用之前完成。所以当CancelAsyncCall尝试取消当前操作时，有时可以完成的所有操作是释放IWbemObjectSink指针。

 

注意可以使用相同的对象接收器进行大量异步调用。在这种情况下，CancelAsyncCall方法将取消共享此对象接收器的所有异步调用。强烈建议您为每个未完成的异步调用创建一个对象宿的一个实例。

 

 

备注

 

因为在客户端需要的相同身份验证级别下，可能不会返回到宿的回调，建议您使用半异步而不是异步通信。有关详细信息，请参阅调用方法.从IWbemObjectSink.Indicate或IWbemObjectSink.SetStatus的实施中调用CancelAsyncCall可能会干扰WMI状态，不建议。

 

在方法调用（例如ExecMethodAsync）的情况下，只有客户端的呼叫被取消。执行提供商不会通知呼叫已被取消并运行完毕。

 

要求