The CLUSCTL_RESOURCE_GET_RO_COMMON_PROPERTIES control code is used to request the read-only common properties for a resource.
Type: | External |
Access: | CLUS_ACCESS_READ |
Input: | None |
Output: | Property list |
Global: | CLUS_NOT_GLOBAL |
Modify: | CLUS_NO_MODIFY |
Code: | CLCTL_GET_RO_COMMON_PROPERTIES |
When you call ClusterResourceControl with the CLUSCTL_RESOURCE_GET_RO_COMMON_PROPERTIES control code, it returns a property list with the names and values of all of the properties that apply to resources of any type and cannot be modified using the CLUSCTL_RESOURCE_SET_COMMON_PROPERTIES control code.
The Name property is the only read-only common property for resources.
For an overall description of the common resource properties, see Common Resource Properties.
To parse the property list returned by ClusterResourceControl, use the property list utility functions.
Do not handle the CLUSCTL_RESOURCE_GET_RO_COMMON_PROPERTIES control code in your ResourceControl entry point function. Instead, have ResourceControl return ERROR_INVALID_FUNCTION. CLUSCTL_RESOURCE_GET_RO_COMMON_PROPERTIES should be handled by the Resource Monitor because it is aware of the valid formats and values for these properties.