Cluster Database Management Functions

The cluster database management functions allow a cluster-aware application or resource DLL to access and update the cluster database. The cluster database management functions provide one way to access the cluster database. The other way is through the control code functions of the Cluster API:

ClusterResourceControl

ClusterResourceTypeControl

ClusterGroupControl

ClusterNodeControl

It is recommended that applications and resource DLLs use the control code functions to access the cluster database. The cluster database management functions should only be used when the control code functions are inadequate. Never use the Win32 registry functions. Although the registry functions are similar to the cluster database management functions, they are unsupported in the cluster environment because they do not support data replication or logging.

The following functions can be used to manage the cluster database:

Function Description
ClusterRegCloseKey Releases the handle of a cluster database key.
ClusterRegCreateKey Creates a specified cluster database key. If the key already exists in the database, ClusterRegCreateKey opens it without making changes.
ClusterRegDeleteKey Deletes a cluster database key.
ClusterRegDeleteValue Removes a named value from a cluster database key.
ClusterRegEnumKey Enumerates the subkeys of an open cluster database key.
ClusterRegEnumValue Enumerates the values of an open cluster database key.
ClusterRegGetKeySecurity Returns a copy of the security descriptor protecting the specified cluster database key.
ClusterRegOpenKey Opens a cluster database key.
ClusterRegQueryInfoKey Returns information about a cluster database key.
ClusterRegQueryValue Returns the name, type, and data components associated with a value for an open cluster database key.
ClusterRegSetKeySecurity Sets the security attributes for a cluster database key.
ClusterRegSetValue Sets a value for a cluster database key.
GetClusterGroupKey Opens the root of the cluster database subtree for a group.
GetClusterKey Opens the root of the cluster database subtree for a cluster.
GetClusterNetInterfaceKey Opens the root of the cluster database subtree for a network interface object.
GetClusterNetworkKey Opens the root of the cluster database subtree for a network.
GetClusterNodeKey Opens the root of the cluster database subtree for a node.
GetClusterResourceTypeKey Opens the root of the cluster database subtree for a resource type.