3.1.4.3.1.14 CLUSCTL_RESOURCE_GET_COMMON_PROPERTY_FMTS

  • Article

The CLUSCTL_RESOURCE_GET_COMMON_PROPERTY_FMTS resource control code SHOULD<157> retrieve the name and data format of each writable common property, as specified in section 3.1.1.9, of the designated resource.

The common properties of a resource are the part of the nonvolatile configuration data of the resource 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, as specified in section 2.2.3.10, to the buffer that is designated by lpOutBuffer. If the lpOutBuffer buffer is not large enough to accommodate the string, error 0x000000EA (ERROR_MORE_DATA) MUST be returned.

Each common property in the returned property list is represented by a property value, as specified in section 2.2.3.10.1, and is of the following format:

  •  A property name structure that MUST begin with the 4-byte CLUSPROP_SYNTAX_NAME value, as specified in section 2.2.2.3.

  • A property values structure, as specified in section 2.2.3.10.1, describing the data format of the property value. The structure MUST begin with 0x0001000B (CLUSPROP_SYNTAX_LIST_VALUE_WORD) value, as specified in section 2.2.2.3, followed by the 4-byte Size field set to 0x00000002, and followed by a 2-byte value from the CLUSTER_PROPERTY_FORMAT enumeration, as specified in section 2.2.2.2, followed by 2 bytes of zero padding.

  • An enumeration value set to CLUSPROP_SYNTAX_ENDMARK.

The server SHOULD accept a CLUSCTL_RESOURCE_GET_COMMON_PROPERTY_FMTS 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.