CoEnableCallCancellation 函式 （combaseapi.h）

啟用取消呼叫線程上的同步呼叫。

語法

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

參數

[in, optional] pReserved

此參數是保留的，且必須為 Null。

返回值

此函式可以傳回標準傳回值 S_OK、E_FAIL、E_INVALIDARG 和 E_OUTOFMEMORY。

備註

在執行程上啟用呼叫取消時，從該執行序封送處理至相同電腦上物件的同步呼叫可能會遭受嚴重的效能降低。 根據預設，即使取消物件可用，也無法取消同步呼叫。 若要啟用通話取消，您必須先呼叫 CoEnableCallCancellation 。

除非您想要隨時在執行程上啟用通話取消，否則您應該將 CoEnableCallCancellation 的呼叫與 CoDisableCallCancellation 的呼叫配對。 只有在每次成功呼叫 CoEnableCallCancellation 時，才會停用 CoDisableCallCancellation 一次。

呼叫是否可取消，取決於呼叫時執行緒的狀態。 後續啟用或停用呼叫取消不會影響執行緒上擱置的任何呼叫。

需求

另請參閱

CoEnableCallCancellation

ICancelMethodCalls