IVdsDisk2：：SetSANMode 方法 (vds.h)

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

将磁盘的 SAN 模式设置为脱机或联机。

注意从 Windows Vista Service Pack 1 (SP1) 开始，此方法由 IVdsDiskOnline：：Online 和 IVdsDiskOnline：：Offline 方法取代。

语法

HRESULT SetSANMode(
  [in] BOOL bEnable
);

[in] bEnable

为联机指定 TRUE ，为脱机指定 FALSE 。

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

返回代码/值	说明
S_OK	已成功设置 SAN 模式。
VDS_E_FAILED_TO_OFFLINE_DISK 0x80042597L	脱机操作失败。
VDS_E_FAILED_TO_ONLINE_DISK 0x80042596L	联机操作失败。

将磁盘的 SAN 模式设置为脱机称为“关闭”磁盘。将其设置为联机称为“内联”磁盘。

Windows Vista： 将磁盘的 SAN 模式设置为脱机也会使磁盘成为只读的。将其设置为联机也会使磁盘读写。