Función CoEnableCallCancellation (combaseapi.h)

Habilita la cancelación de llamadas sincrónicas en el subproceso que realiza la llamada.

Syntax

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

Parámetros

[in, optional] pReserved

Este parámetro está reservado y debe ser NULL.

Valor devuelto

Esta función puede devolver los valores devueltos estándar S_OK, E_FAIL, E_INVALIDARG y E_OUTOFMEMORY.

Observaciones

Cuando la cancelación de llamadas está habilitada en un subproceso, las llamadas sincrónicas serialadas de ese subproceso a objetos del mismo equipo pueden sufrir una degradación grave del rendimiento. De forma predeterminada, las llamadas sincrónicas no se pueden cancelar, incluso si hay un objeto cancel disponible. Para habilitar la cancelación de llamadas, primero debe llamar a CoEnableCallCancellation .

A menos que quiera habilitar la cancelación de llamadas en un subproceso en todo momento, debe emparejar llamadas a CoEnableCallCancellation con llamadas a CoDisableCallCancellation. La cancelación de llamadas solo se deshabilita si se ha llamado a CoDisableCallCancellation una vez por cada vez que se llamó correctamente a CoEnableCallCancellation .

Una llamada será cancelable o no dependiendo del estado del subproceso en el momento en que se realizó la llamada. Posteriormente, habilitar o deshabilitar la cancelación de llamadas no tiene ningún efecto en las llamadas pendientes en el subproceso.

Requisitos

Consulte también

CoEnableCallCancellation

ICancelMethodCalls