220.127.116.11.3 ApiSetClusterName (Opnum 2)
(Protocol Version 3) The ApiSetClusterName method changes the name of the cluster.
error_status_t ApiSetClusterName( [in, string] LPCWSTR NewClusterName, [out] error_status_t* rpc_status );
NewClusterName: A pointer to a case-insensitive Unicode string indicating the new name for the cluster. The new name consists of a DNS host name (in the format of a label as specified in [RFC1035]) and MUST NOT exceed 128 bytes (64 Unicode characters), including the terminating null character.
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: The method MUST return the following error codes for the specified conditions.
Return value/code Description
The NewClusterName parameter is already used as the name of a configured node.
The NewClusterName parameter exceeds 128 bytes (64 Unicode characters), including the terminating null character.
The cluster name could not be changed because the resource associated with the primary security principal of the cluster is in the ClusterResourceOnline state.
The resource associated with the primary security principal of the cluster is in the ClusterResourceOnline or ClusterResourceOnlinePending state, and the value of the NewClusterName parameter is the same as the current name of the cluster. If this condition applies, the server MUST ensure that the value of NewClusterName is stored in the nonvolatile cluster state and then return this error code.
For any other condition, the server MUST set Status to 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 the same, except as specified in section 18.104.22.168.