ApiCancelClusterGroupOperation (Opnum 134)

(Protocol Version 3) The ApiCancelClusterGroupOperation SHOULD<110>allow a client to cancel a pending group move operation.

The server MUST fail this method with error 0x0000139F (ERROR_INVALID_STATE) if the specified group is not in the ClusterGroupPending state (section or if the server is not retrying a move operation due to the CLUSAPI_GROUP_MOVE_QUEUE_ENABLED flag, as specified in sections and The server SHOULD fail this method with 0x0000139F (ERROR_INVALID_STATE) if the server determines that there is no operation in progress for the designated group that can be canceled. How the server determines whether there is a cancellable operation in progress is implementation-specific.

If the server accepts the ApiCancelClusterGroupOperation request and will process it asynchronously, the server MUST return ERROR_IO_PENDING.

The server accepts an ApiCancelClusterGroupOperation request only if it is in the read/write state, as specified in section 3.1.1.

The server MUST require that the access level associated with the hGroup parameter is "All" (section 3.1.4).

 error_status_t ApiCancelClusterGroupOperation(
   [in] HGROUP_RPC hGroup,
   [in] DWORD dwCancelFlags,
   [out] error_status_t *rpc_status

hGroup: An HGROUP_RPC context handle that was obtained in a previous call to ApiOpenGroup (section, ApiOpenGroupEx (section, or ApiCreateGroup (section

dwCancelFlags: Reserved. The client MUST set this parameter to 0.

rpc_status: A 32-bit integer used to indicate success or failure. The RPC runtime MUST indicate, by writing to this parameter, whether it succeeded in executing this method on the server. The encoding of the value passed in this parameter MUST conform to encoding for comm_status and fault_status, as specified in Appendix E of [C706].

Return Values: This method MUST return one of the following values.

Return value/code




The method completed successfully.



Access is denied.



The dwCancelFlags parameter is not set to 0.



The hGroup parameter does not represent a valid HGROUP_RPC context handle.



The server has accepted the request and will process it asynchronously.



The specified group is not moving or the group move operation is no longer cancellable.

For any other condition, the server returns a value that is not one of the values listed in the preceding table. The client MUST treat all values that are not listed in the preceding table identically. However, the client SHOULD treat errors specified in section as recoverable errors and initiate the reconnect procedure as specified in section