SetClusterName function (clusapi.h)
Sets the name for a cluster. The PCLUSAPI_SetClusterName type defines a pointer to this function.
Syntax
DWORD SetClusterName(
[in] HCLUSTER hCluster,
[in] LPCWSTR lpszNewClusterName
);
Parameters
[in] hCluster
Handle to a cluster to rename.
[in] lpszNewClusterName
Pointer to a null-terminated Unicode string containing the new cluster name.
Return value
If the operation succeeds, the function returns ERROR_RESOURCE_PROPERTIES_STORED.
If the operation fails, the function returns a system error code.
Remarks
The cluster name is stored in the Name private property of the core Network Name resource (that is, the Network Name resource of the cluster). Because of possible dependencies on this resource, the change is not effective until the Network Name resource is brought back online.
Do not call SetClusterName from a resource DLL. For more information, see Function Calls to Avoid in Resource DLLs.
Requirements
Requirement | Value |
---|---|
Minimum supported client | None supported |
Minimum supported server | Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
Target Platform | Windows |
Header | clusapi.h |
Library | ClusAPI.lib |
DLL | ClusAPI.dll |