Changing Object Names
Cluster-aware applications typically allow administrators to control changes to existing cluster object names. As an analogy, most applications allow users to control path and file name changes. In both cases, the user is in the best position to assess the impact of the name change on other applications and to choose a name that is consistent with other names.
The following API elements can be used to safely change object names.
| Name to change | Function to use |
|---|---|
| cluster name |
SetClusterName |
| group name |
SetClusterGroupName |
| network name |
SetClusterNetworkName |
| resource name |
SetClusterResourceName |
Note
- Resource DLLs are notified of cluster and resource name changes with the CLUSCTL_RESOURCE_CLUSTER_NAME_CHANGED and CLUSCTL_RESOURCE_SET_NAME control codes.
- Object names are stored as read-onlycommon properties. Thus it is possible to change object names using the cluster database access functions, but it is dangerous to do so. The cluster database access functions may not generate all of the required notifications, resulting in unusable objects or an unusable cluster.