Share via

3.1.4.3.1.48 CLUSCTL_RESOURCE_STORAGE_GET_SHARED_VOLUME_INFO

  • Article

The CLUSCTL_RESOURCE_STORAGE_GET_SHARED_VOLUME_INFO resource control code retrieves information about all of the cluster shared volumes associated with the storage class resource designated by hResource.

ClusAPI Protocol version 2.0 servers SHOULD fail this method by using error code ERROR_INVALID_FUNCTION (0x00000001).

ClusAPI Protocol version 3.0 servers SHOULD<170> support this resource control code.

The server MUST fail this method by using error ERROR_INVALID_FUNCTION (0x00000001) if the resource designated by hResource does not contain a cluster shared volume (ResourceSharedVolumes MUST be TRUE).

If the resource designated by hResource is not in the ClusterResourceOnline state, then the server MUST return error code ERROR_RESOURCE_NOT_ONLINE (0x0000138C).

After successful completion of this method, the server MUST write a PROPERTY_LIST (section 2.2.3.10) value list to the buffer that is designated by lpOutBuffer. This value list MUST consist of one CLUSPROP_SYNTAX_LIST_VALUE_BINARY (section 2.2.2.3) for each cluster shared volume associated with the designated resource. Each value Buffer MUST contain a unique CLUS_CSV_VOLUME_INFO (section 2.2.3.18) structure providing information about a cluster shared volume associated with the designated resource. If the lpOutBuffer buffer is not large enough to accommodate the resulting PROPERTY_LIST value list, then the server MUST return error ERROR_MORE_DATA (0x000000EA).

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