CLUSCTL_RESOURCE_GET_PRIVATE_PROPERTIES

The CLUSCTL_RESOURCE_GET_PRIVATE_PROPERTIES control code is used to request the read/write private properties for a resource.

Quick Info

Notes to Callers

When you call ClusterResourceControl with the CLUSCTL_RESOURCE_GET_PRIVATE_PROPERTIES control code, it returns a property list with the names and values of all of the properties that apply only to the specific resource and to all others of its type and can be modified using the CLUSCTL_RESOURCE_SET_PRIVATE_PROPERTIES control code. Private properties can include:

• Dynamic values generated as needed.
• Static values stored in the cluster database.
• Static values not stored in the cluster database.

To parse the property list returned by ClusterResourceControl, use the property list utility functions.

For an overall description of the private properties for resources belonging to the Cluster Server resource types, see Private Resource Properties.

Notes to Resource DLL Writers

Resource DLLs should always support the CLUSCTL_RESOURCE_GET_PRIVATE_PROPERTIES control code in their ResourceControl entry point functions. If you do not support this control code, the command tool CLUSTER.EXE cannot set any non string properties that have not already been set. The output should be a property list that includes the names and data values for all of the read/write properties specific to your resource. It is important to remember to terminate the list with a final entry that contains only the CLUSPROP_SYNTAX_ENDMARK value.

The Resource Monitor does not provide any default handling of this control code.