3.1.4.3.4.14 CLUSCTL_NODE_GET_PRIVATE_PROPERTIES

  • Article

The CLUSCTL_NODE_GET_PRIVATE_PROPERTIES node control code retrieves any unknown properties associated with the designated node, as specified in section 3.1.1.9.

The unknown properties of a node are the part of the node's non-volatile configuration data that is maintained in the cluster state and whose schema is defined by an entity external to the cluster.

After successful completion of this method, the server MUST write a PROPERTY_LIST structure to the buffer that is designated by lpOutBuffer. This PROPERTY_LIST structure MUST contain zero or more names and values of all of the unknown properties associated with the designated node. This PROPERTY_LIST structure MUST use the format specified in section 2.2.3.10. 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_NODE_GET_PRIVATE_PROPERTIES node 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.