CoEnableCallCancellation 函数 （combaseapi.h）

启用对调用线程的同步调用取消。

Syntax

HRESULT CoEnableCallCancellation(
  [in, optional] LPVOID pReserved
);

参数

[in, optional] pReserved

此参数是保留的，必须为 NULL。

返回值

此函数可以返回标准返回值S_OK、E_FAIL、E_INVALIDARG和E_OUTOFMEMORY。

注解

在线程上启用调用取消时，将来自该线程的同步调用封送到同一计算机上的对象可能会严重性能下降。 默认情况下，即使取消对象可用，也无法取消同步调用。 若要启用呼叫取消，必须先调用 CoEnableCallCancellation 。

除非你希望随时在线程上启用调用取消，否则应将对 CoEnableCallCancellation 的调用与对 CoDisableCallCancellation 的调用配对。 仅当每次成功调用 CoEnableCallCancellation 时，才会禁用调用取消调用。

调用将被取消或不取决于调用时线程的状态。 随后启用或禁用调用取消不会影响线程上挂起的任何调用。

要求

另请参阅

CoEnableCallCancellation

ICancelMethodCalls