Функция CoEnableCallCancellation (combaseapi.h)

Включает отмену синхронных вызовов в вызывающем потоке.

Синтаксис

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

Параметры

[in, optional] pReserved

Этот параметр зарезервирован и должен иметь значение NULL.

Возвращаемое значение

Эта функция может возвращать стандартные возвращаемые значения S_OK, E_FAIL, E_INVALIDARG и E_OUTOFMEMORY.

Замечания

Если в потоке включена отмена вызова, маршалированные синхронные вызовы из этого потока к объектам на одном компьютере могут страдать от серьезного снижения производительности. По умолчанию синхронные вызовы не могут быть отменены, даже если объект отмены доступен. Чтобы включить отмену вызова, сначала необходимо вызвать CoEnableCallCancellation .

Если вы не хотите включить отмену вызовов в потоке, следует связать вызовы CoEnableCallCancellation с вызовами CoDisableCallCancellation. Отмена вызова отключена только в том случае, если CoDisableCallCancellation был вызван один раз при каждом вызове CoEnableCallCancellation .

Вызов будет отменен или не зависит от состояния потока во время вызова. Впоследствии включение или отключение отмены вызова не влияет на вызовы, ожидающие в потоке.

Требования

Требование	Ценность
Минимальный поддерживаемый клиент	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
Header	combaseapi.h (include Objbase.h)
Library	Ole32.lib
DLL	Ole32.dll

См. также

CoEnableCallCancellation

ICancelMethodCalls