Share via

3.1.4.3.1.17 CLUSCTL_RESOURCE_GET_PRIVATE_PROPERTIES

  • Article

The CLUSCTL_RESOURCE_GET_PRIVATE_PROPERTIES resource control code retrieves the private and unknown properties of the designated resource, as specified in section 3.1.1.9.

The private and unknown properties of a resource are the part of the non-volatile configuration data of the resource that is maintained in the cluster state. Private property schema is specific to the resource type of the resource, while unknown property schema is defined by an entity external to the cluster.

After successful completion of this method, the server MUST write a PROPERTY_LIST structure, as specified in section 2.2.3.10, to the buffer that is designated by lpOutBuffer containing zero or more names and values of the writable private and all unknown properties for the designated resource. If the lpOutBuffer buffer is not large enough to accommodate the string, error 0x000000EA (ERROR_MORE_DATA) MUST be returned.

The server SHOULD accept a CLUSCTL_RESOURCE_GET_PRIVATE_PROPERTIES resource control code request if its protocol server state is read-only and MUST accept the request for processing if it is in the read/write state, as specified in section 3.1.1.