3.2.4.4.1.56 IVolumeClient::Refresh (Opnum 73)

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

 HRESULT Refresh();

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 server MUST process the message as follows:

  1. Re-enumerate disks, disk regions, volumes, drive letters, and file systems from the system.

  2. If discrepancies between the enumerated objects and the list of storage objects stored by the server are found, the server MUST make the appropriate changes to the list of storage objects and send appropriate notifications to the clients.

  3. Return a response to the client that contains the status of the operation.