|  |  |  | Evolution Connector for Microsoft Exchange Programmer’s Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | ||||
struct E2kOperation; void e2k_operation_init (E2kOperation *op); void e2k_operation_cancel (E2kOperation *op); gboolean e2k_operation_is_cancelled (E2kOperation *op); void e2k_operation_free (E2kOperation *op);
E2kOperation represents a handle which can be used to cancel a pending operation (where the operation may be composed of several cancellable steps).
void                e2k_operation_init                  (E2kOperation *op);
This initializes the E2kOperation pointed to by op.
This should be called before passing op to a cancellable function.
| 
 | an E2kOperation | 
void                e2k_operation_cancel                (E2kOperation *op);
This cancels op, invoking its cancellation callback. If op is not
an active operation, or has already been cancelled, this has no
effect.
| 
 | an E2kOperation | 
gboolean            e2k_operation_is_cancelled          (E2kOperation *op);
Checks if op has been cancelled. Should only be called while op
is active.
| 
 | an E2kOperation (or NULL) | 
| Returns : | whether or not ophas been cancelled. | 
void                e2k_operation_free                  (E2kOperation *op);
This frees op and removes it from the list of active operations.
It should be called after the function it was passed to returns.
| 
 | an E2kOperation |