CLUSCTL_RESOURCE_ENUM_PRIVATE_PROPERTIES

The CLUSCTL_RESOURCE_ENUM_PRIVATE_PROPERTIES control code is used to retrieve a list of private 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_PRIVATE_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_PRIVATE_PROPERTIES control code. To update them, use the CLUSCTL_RESOURCE_SET_PRIVATE_PROPERTIES control code. To validate them, use CLUSCTL_RESOURCE_VALIDATE_PRIVATE_PROPERTIES.

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

Notes to Resource DLL Writers

Always support the CLUSCTL_RESOURCE_ENUM_PRIVATE_PROPERTIES control code in your ResourceControl entry point function by returning the names of your private properties in the string array. However, if you do not provide support, the Resource Monitor returns what has been set for the resource.