CLUSCTL_RESOURCE_TYPE_ENUM_PRIVATE_PROPERTIES

The CLUSCTL_RESOURCE_TYPE_ENUM_PRIVATE_PROPERTIES control code is used to retrieve a list of private resource type 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 values for the read/write properties, call ClusterResourceTypeControl with the CLUSCTL_RESOURCE_TYPE_GET_PRIVATE_PROPERTIES control code. To update them, use the CLUSCTL_RESOURCE_TYPE_SET_PRIVATE_PROPERTIES control code. To validate them, use CLUSCTL_RESOURCE_TYPE_VALIDATE_PRIVATE_PROPERTIES.

The CLUSCTL_RESOURCE_TYPE_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_TYPE_ENUM_PRIVATE_PROPERTIES control code in your ResourceTypeControl entry point function by returning the names of your private properties in the string array. However, if you do not support this control code, the Resource Monitor returns what has been set for the resource type.