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模式設定為離線，也會讓磁碟變成唯讀。將它設定為在線也會讓磁碟可擦寫。