Share via

3.1.4.3.1.18 CLUSCTL_RESOURCE_SET_PRIVATE_PROPERTIES

  • Article

The CLUSCTL_RESOURCE_SET_PRIVATE_PROPERTIES resource control code stores the private and unknown properties, as specified in section 3.1.1.9, of the designated resource as part of the non-volatile cluster state of the resource.

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.

The client MUST provide one or more private and/or unknown property names and their associated values, by using the format as specified in section 2.2.3.10, in the buffer that is designated by lpInBuffer.

The server SHOULD fail this method if validation of the private property names and values, as specified in section 3.1.4.3.1.19, fails.

After successful completion of the method, the server SHOULD NOT write any data to the buffer that is designated by lpOutBuffer.

The server MUST store the data values to the non-volatile cluster state and return 0x000013A0 (ERROR_RESOURCE_PROPERTIES_STORED) if the resource is in the ClusterResourceOnline state and is unable to immediately affect the behavior of the resource such that the change in its private properties is visible to entities external to the cluster.

The server MUST accept a CLUSCTL_RESOURCE_SET_PRIVATE_PROPERTIES resource control code request if its protocol server state is in the read/write state, as specified in section 3.1.1.