Share via

3.1.4.3.4.8 CLUSCTL_NODE_GET_RO_COMMON_PROPERTIES

  • Article

The CLUSCTL_NODE_GET_RO_COMMON_PROPERTIES node control code retrieves the read-only common properties, as specified in section 3.1.1.9, of the designated node.

The common 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 the server.

After successful completion of this method, the server MUST write a PROPERTY_LIST structure (section 2.2.3.10) to the buffer that is designated by lpOutBuffer. This PROPERTY_LIST structure MUST contain zero or more names and values of the read-only common properties for the designated node. 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_RO_COMMON_PROPERTIES node control code request if its protocol server state is read-only, and the server MUST accept the request for processing if it is in the read/write state, as specified in section 3.1.1.