ICancelMethodCalls

[This is preliminary documentation and subject to change.]

The ICancelMethodCalls interface manages cancellation requests on an outbound method call and monitors the current state of that method call on the server thread.

When to Implement

For objects that use standard marshaling, COM automatically creates cancel objects and implements ICancelMethodCalls on them. For objects that use custom marshaling, you must implement your own corresponding cancel object and implement ICancelMethodCalls on that object.

When to Use

A thread that is blocked because an outbound synchronous method call is pending calls the methods of ICancelMethodCalls on its corresponding cancel object to determine the current state of the pending call or to request that the call be canceled.

Methods in Vtable Order

IUnknown Methods Description
QueryInterface Returns pointers to supported interfaces.
AddRef Increments reference count.
Release Decrements reference count.

ICancelMethodCalls Methods Description
Cancel Requests that a method call be canceled.
TestCancel Determines if a call has been canceled.
SetCancelTimeout Specifies the timeout period for a cancellation request.

QuickInfo

  Windows NT: Use version 5.0 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in objidl.h.

See Also

IMessageFilter