CoSetCancelObject function (combaseapi.h)

Sets (registers) or resets (unregisters) a cancel object for use during subsequent cancel operations on the current thread.

Syntax

HRESULT CoSetCancelObject(
  [in, optional] IUnknown *pUnk
);

Parameters

[in, optional] pUnk

Pointer to the IUnknown interface on the cancel object to be set or reset on the current thread. If this parameter is NULL, the topmost cancel object is reset.

Return value

This function can return the standard return values E_FAIL, E_INVALIDARG, E_OUTOFMEMORY, and E_UNEXPECTED, as well as the following values.

Remarks

For objects that support standard marshaling, the proxy object begins marshaling a method call by calling CoSetCancelObject to register a cancel object for the current thread.

CoSetCancelObject calls QueryInterface for ICancelMethodCalls on the cancel object. If the cancel object does not implement ICancelMethodCalls, CoSetCancelObject fails with E_NOINTERFACE. To disable cancel operations on a custom-marshaled interface, the implementation of ICancelMethodCalls::Cancel should do nothing but return E_NOTIMPL, E_FAIL, or some other appropriate value.

CoSetCancelObject calls AddRef on objects that it registers and Release on objects that it unregisters.

CoSetCancelObject does not set or reset cancel objects for asynchronous methods.

Requirements

See also

ICancelMethodCalls