Função CoEnableCallCancellation (combaseapi.h)

Habilita o cancelamento de chamadas síncronas no thread de chamada.

Sintaxe

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

Parâmetros

[in, optional] pReserved

Esse parâmetro é reservado e deve ser NULL.

Valor de retorno

Essa função pode retornar os valores de retorno padrão S_OK, E_FAIL, E_INVALIDARG e E_OUTOFMEMORY.

Observações

Quando o cancelamento de chamada é habilitado em um thread, chamadas síncronas marshaladas desse thread para objetos no mesmo computador podem sofrer grave degradação de desempenho. Por padrão, as chamadas síncronas não podem ser canceladas, mesmo se um objeto de cancelamento estiver disponível. Para habilitar o cancelamento de chamadas, você deve chamar CoEnableCallCancellation primeiro.

A menos que você queira habilitar o cancelamento de chamadas em um thread o tempo todo, você deve emparelhar chamadas para CoEnableCallCancellation com chamadas para CoDisableCallCancellation. O cancelamento de chamadas só será desabilitado se CoDisableCallCancellation tiver sido chamado uma vez para cada vez que CoEnableCallCancellation foi chamado com êxito.

Uma chamada será cancelável ou não dependendo do estado do thread no momento em que a chamada foi feita. Posteriormente, habilitar ou desabilitar o cancelamento de chamadas não tem efeito sobre as chamadas pendentes no thread.

Requirements

Consulte também

CoEnableCallCancellation

ICancelMethodCalls