Edit

IVdsVolumeOnline::Online method (vds.h)

  • Article

[Beginning with Windows 8 and Windows Server 2012, the Virtual Disk Service COM interface is superseded by the Windows Storage Management API.]

Returns a volume to the healthy state, if possible. This method is supported only for dynamic disks.

Syntax

HRESULT Online();

Return value

This method can return standard HRESULT values, such as E_OUTOFMEMORY, and VDS-specific return values. It can also return converted system error codes using the HRESULT_FROM_WIN32 macro. Errors can originate from VDS itself or from the underlying VDS provider that is being used. Possible return values include the following.

Return code/value Description
S_OK
 The method completed successfully.
VDS_S_NO_NOTIFICATION
0x00042517L
 No volume arrival notification was received. You may need to call IVdsService::Refresh.
VDS_E_NOT_SUPPORTED
0x80042400L
 This method is not supported for basic disks.

Remarks

Despite its name, this method does not bring a volume online. It attempts to return a volume on a dynamic disk to a healthy state.

This method checks whether the volume has a missing disk, plex, or RAID-5 column and attempts to make any needed repairs.

To bring the volume online, call IVdsVolumeMF::Mount.

To take the volume offline, call IVdsVolumeMF::Dismount with the bPermanent parameter set to TRUE.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header vds.h
Library Uuid.lib

See also

IVdsVolumeOnline