Share via

3.1.4.3.4.20 CLUSCTL_NODE_GET_SBL_DISK_STATE_EX

  • Article

The CLUSCTL_NODE_GET_SBL_DISK_STATE_EX node control code<203> retrieves the disk state of the storage unit.

ClusAPI Protocol version 2.0 servers do not support this control and MUST fail this method using error code 0x00000001 (ERROR_INVALID_FUNCTION).

The client MUST provide a CLUS_GET_SBL_DISK_STATE_EX_IN (section 2.2.3.53) structure in the buffer that is designated by lpInBuffer.

After successful completion of the method, the server MUST update the disk state information for all disks connected to the storage that is designated by lpOutBuffer. If the lpOutBuffer buffer is not large enough to accommodate the storage disk state information, error 0x000000EA (ERROR_MORE_DATA) MUST be returned.

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

The server MUST update the CLUS_GET_SBL_DISK_STATE_OUT (section 2.2.3.55) structure to buffer designated by lpOutBuffer.