Share via

3.1.4.3.1.56 CLUSCTL_RESOURCE_POOL_GET_DRIVE_INFO

  • Article

The CLUSCTL_RESOURCE_POOL_GET_DRIVE_INFO resource control code returns information about the drives in a storage pool. ClusAPI Protocol version 2.0 servers fail this method using error code ERROR_INVALID_FUNCTION (0x00000001). ClusAPI Protocol version 3.0 servers SHOULD<178> support this control code.

After successful completion of the method, the server MUST write an array of CLUS_POOL_DRIVE_INFO (section 2.2.3.31) structures, one for each drive in the storage pool, to the buffer designated by lpOutBuffer. If the size of lpOutBuffer, as designated by nOutBufferSize, is not sufficient to contain the array, the server MUST return ERROR_MORE_DATA (0x000000EA) and set lpcbRequired to the number of bytes that are required for the output buffer.

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