CLUSCTL_RESOURCE_ENUM_COMMON_PROPERTIES

The CLUSCTL_RESOURCE_ENUM_COMMON_PROPERTIES control code is used to retrieve a list of the common resource properties.

Quick Info

Type: External
Access: CLUS_ACCESS_READ
Input: None
Output: Array of null-terminated Unicode strings with an additional null terminator appended to the last string.
Global: CLUS_NOT_GLOBAL
Modify: CLUS_NO_MODIFY
Code: CLCTL_ENUM_COMMON_PROPERTIES

Notes to Callers

The properties that are returned in the contents of the lpOutBuffer parameter are of two types: read/write and read-only.

To retrieve the values for the read/write properties, call ClusterResourceControl with the CLUSCTL_RESOURCE_GET_COMMON_PROPERTIES control code. To update them, use the CLUSCTL_RESOURCE_SET_COMMON_PROPERTIES control code. To validate them, use CLUSCTL_RESOURCE_VALIDATE_COMMON_PROPERTIES.

The CLUSCTL_RESOURCE_GET_RO_COMMON_PROPERTIES control code enables you to retrieve values for the read-only properties.

Notes to Resource DLL Writers

Avoid supporting the CLUSCTL_RESOURCE_ENUM_COMMON_PROPERTIES control code. Allow the Resource Monitor to handle it by returning ERROR_INVALID_FUNCTION from your ResourceControl entry point function. The Resource Monitor should handle all of the control codes for common properties.