[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.
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.
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.
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. |
Windows NT: Use version 5.0 or later.
Windows: Unsupported.
Windows CE: Unsupported.
Header: Declared in objidl.h.