CLUSCTL_RESOURCE_GET_RO_PRIVATE_PROPERTIES

The CLUSCTL_RESOURCE_GET_RO_PRIVATE_PROPERTIES control code is used to request the read-only private properties for a resource.

Quick Info

Remarks

When you call ClusterResourceControl with the CLUSCTL_RESOURCE_GET_RO_PRIVATE_PROPERTIES control code, it returns a property list with the names and values of the properties that apply to the specific resource and cannot 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 must always support the CLUSCTL_RESOURCE_GET_RO_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-only properties specific to their resource, if there are any. 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.