Share via

3.2.4.4.4.1 IVolumeClient4::RefreshEx (Opnum 3)

  • Article

The RefreshEx method refreshes the server's cache of storage objects, including regions, removable media and CD-ROM drive media, file systems, and drive letters.

 HRESULT RefreshEx(void);

This method has no parameters.

Return Values: The method MUST return 0 or a nonerror HRESULT on success, or an implementation-specific nonzero error code on failure (as specified in [MS-ERREF]; see also section 2.2.1 for HRESULT values predefined by the Disk Management Remote Protocol).

The handling of this message is identical to the handling of IVolumeClient::Refresh and IVolumeClient3::Refresh except that the server MUST perform an extra low-level refresh of the list of storage objects by looking for missing dynamic disks or dynamic disks that were missing and are now present. This verification updates the status for missing disks, volumes that reside on missing disks, or disk regions that reside on missing disks.<228>

In addition to the preceding actions, the server MUST check whether the lengths of the disks have changed and make appropriate changes to the disk objects in the list of storage objects.