CoEnableCallCancellation 函式 (combaseapi.h)
允許取消呼叫線程上的同步呼叫。
語法
HRESULT CoEnableCallCancellation(
[in, optional] LPVOID pReserved
);
參數
[in, optional] pReserved
此參數是保留的,而且必須是 NULL。
傳回值
此函式可以傳回標準傳回值S_OK、E_FAIL、E_INVALIDARG和E_OUTOFMEMORY。
備註
在線程上啟用呼叫取消時,將同步呼叫從該線程封送處理至相同計算機上的物件可能會嚴重效能降低。 根據預設,即使有 cancel 物件可用,仍無法取消同步呼叫。 若要啟用通話取消,您必須先呼叫 CoEnableCallCancellation 。
除非您想要隨時在線程上啟用呼叫取消,否則您應該將呼叫配對至 CoEnableCallCancellation 與 CoDisableCallCancellation 的呼叫。 只有在每次呼叫 CoEnableCallCancellation 成功呼叫 CoEnableCallCancellation 時,才會停用呼叫取消。
呼叫將會是可取消的,或不取決於進行呼叫時線程的狀態。 後續啟用或停用呼叫取消,不會影響線程上擱置的任何呼叫。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | combaseapi.h (包含 Objbase.h) |
程式庫 | Ole32.lib |
Dll | Ole32.dll |