3.1.4.3.7.33.2 CLUSCTL_AFFINITYRULE_GET_RO_COMMON_PROPERTIES

The CLUSCTL_AFFINITYRULE_GET_RO_COMMON_PROPERTIES affinity rule control code retrieves the read-only common properties, as specified in section 3.1.1.9, of the designated affinity rule.

The common properties of an affinity rule are the part of the cluster's nonvolatile 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, 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 read-only common properties for the designated affinity rule. If the designated affinity rule has no read-only common properties, the server MUST return data, as specified in section 2.2.3.10, that indicates there are no properties of this designation. 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_AFFINITYRULE_GET_RO_COMMON_PROPERTIES affinity rule 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.