18.104.22.168.133 ApiCancelClusterGroupOperation (Opnum 135)
(Protocol Version 3) The ApiCancelClusterGroupOperation allows a client to cancel a pending group move operation.
Servers SHOULD<103> support this method.
The server MUST fail this method with error 0x0000139F (ERROR_INVALID_STATE) if the specified group is not in the ClusterGroupPending state (section 22.214.171.124.46) or if the server is not retrying a move operation due to the CLUSAPI_GROUP_MOVE_QUEUE_ENABLED flag, as specified in sections 126.96.36.199.131 and 188.8.131.52.132. 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 MUST accept 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).
void ApiCancelClusterGroupOperation( [in] HGROUP_RPC hGroup, [in] DWORD dwCancelFlags, [out] error_status_t* rpc_status );
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:
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 MUST return 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 184.108.40.206 as recoverable errors and initiate the reconnect procedure as specified in section 220.127.116.11.