Share via

3.1.4.3.1.38 CLUSCTL_RESOURCE_STORAGE_GET_DISK_INFO

  • Article

The CLUSCTL_RESOURCE_STORAGE_GET_DISK_INFO resource control code retrieves a PROPERTY_LIST value list (section 2.2.3.10.1) that contains information about the disk that is represented by the designated storage class resource.

The server MUST fail this method by using error code 0x00000001 (ERROR_INVALID_FUNCTION) if the designated resource is not in class CLUS_RESCLASS_STORAGE, as specified in section 3.1.4.3.1.4.

After successful completion of this method, the server MUST return a value list as follows:

  •  For ClusAPI Protocol version 2.0, the value list MUST begin with a CLUSPROP_SYNTAX_DISK_SIGNATURE value, as specified in section 2.2.2.3, that specifies the disk signature of a master boot record (MBR) disk.

  • For ClusAPI Protocol version 3.0, the value list MUST begin with either a CLUSPROP_SYNTAX_DISK_SIGNATURE value that specifies the disk signature of an MBR disk, or if the disk is a GPT disk, a CLUSPROP_SYNTAX_DISK_GUID value that specifies the disk GUID.

Following the disk signature value, which is a GUID for GPT disks in version 3.0, the value list MAY contain the following values in any order:

  •  A CLUSPROP_SYNTAX_SCSI_ADDRESS value, as specified in section 2.2.2.3, that specifies the SCSI address of the device that is represented by the storage class resource, if applicable.

  • A CLUSPROP_SYNTAX_DISK_NUMBER value, as specified in section 2.2.2.3, that specifies the disk number of the storage class resource, if applicable.

  • One CLUSPROP_SYNTAX_PARTITION_INFO value, as specified in section 2.2.2.3, for each partition that has a basic volume that is assigned to the storage class resource, if applicable.

As specified in section 2.2.3.10.1, the value list MUST be terminated by a CLUSPROP_SYNTAX_ENDMARK.

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