IVdsVolumeMF3::OfflineVolume 方法 (vds.h)

[从 Windows 8 和 Windows Server 2012 开始,虚拟磁盘服务 COM 接口由 Windows 存储管理 API 取代。]

使用 IOCTL_VOLUME_OFFLINE 控制代码将卷脱机。

语法

HRESULT OfflineVolume();

返回值

此方法可以返回标准 HRESULT 值,例如E_INVALIDARG或E_OUTOFMEMORY,以及 特定于 VDS 的返回值。 它还可以使用 HRESULT_FROM_WIN32 宏返回转换的系统错误代码。 错误可能源自 VDS 本身或正在使用的基础 VDS 提供程序 。 可能的返回值包括以下内容。

返回代码 说明
S_OK
该方法已成功完成。

备注

如果卷已脱机, 则 OfflineVolume 方法返回S_OK。

当卷处于脱机状态时,所有读取、写入和 IOCTL 请求都会失败并 ERROR_NOT_READY。 无法使系统或启动卷脱机。

当卷处于联机状态时,将接受发送到该卷的所有请求。

当卸载联机卷时,下一次调用打开卷会导致装载该卷。 使卷脱机可防止再次装载已卸载的卷。 若要卸载卷,请使用 IVdsVolumeMF::D ismount 方法。

要求

要求
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 vds.h
Library Uuid.lib

另请参阅

IVdsVolumeMF3