IVdsVolumeMF::Dismount method (vds.h)
[Beginning with Windows 8 and Windows Server 2012, the Virtual Disk Service COM interface is superseded by the Windows Storage Management API.]
Dismounts a mounted volume.
Syntax
HRESULT Dismount(
[in] BOOL bForce,
[in] BOOL bPermanent
);
Parameters
[in] bForce
If TRUE, the volume is dismounted even if it is in use; otherwise, the operation fails if the volume is in use.
[in] bPermanent
If TRUE, the volume remains dismounted until an access path is added.
Return value
This method can return standard HRESULT values, such as E_INVALIDARG or 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 |
---|---|
|
The method completed successfully. |
|
The volume is already dismounted. |
|
The volume cannot be dismounted. It does not support the operation. |
|
The volume is already dismounted. It cannot be dismounted temporarily until it becomes mountable. |
|
The volume cannot be dismounted because it still has an access path. |
|
The volume is in use and cannot be dismounted. |
Remarks
To mount a volume, use the Mount method.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows Vista [desktop apps only] |
Minimum supported server | Windows Server 2003 [desktop apps only] |
Target Platform | Windows |
Header | vds.h |
Library | Uuid.lib |