VDS_SAN_POLICY列舉 (vds.h)

  • 發行項

[從 Windows 8 和 Windows Server 2012 開始，虛擬磁碟服務 COM 介面會由 Windows 記憶體管理 API 取代。

定義有效的磁碟 SAN 原則旗標集合。

Syntax

typedef enum _VDS_SAN_POLICY {
  VDS_SP_UNKNOWN = 0,
  VDS_SP_ONLINE = 0x1,
  VDS_SP_OFFLINE_SHARED = 0x2,
  VDS_SP_OFFLINE = 0x3,
  VDS_SP_OFFLINE_INTERNAL = 0x4,
  VDS_SP_MAX = 0x5
} VDS_SAN_POLICY;

常數

 
VDS_SP_UNKNOWN
值： 0
SAN 原則未知。
VDS_SP_ONLINE
值： 0x1
所有新探索到的磁碟都會上線並進行讀寫。
VDS_SP_OFFLINE_SHARED
值： 0x2
所有未位於共用總線上新探索到的磁碟都會上線並進行讀寫。
VDS_SP_OFFLINE
值： 0x3
所有新探索到的磁碟都會保持離線且唯讀。
VDS_SP_OFFLINE_INTERNAL
值： 0x4
VDS_SP_MAX
值： 0x5

備註

SAN 原則會決定新探索到的磁碟是上線還是保持離線狀態，以及它是否變成讀取/寫入或維持唯讀狀態。 當磁碟脫機時，可以讀取磁碟配置，但不會透過 隨插即用 (PnP) 顯示磁碟區裝置。 這表示無法將文件系統掛接在磁碟上。 當磁碟上線時，會為磁碟安裝一或多個磁碟區裝置。

若要查詢目前的 SAN 原則，請使用 IVdsServiceSAN：：GetSANPolicy 方法。

若要設定 SAN 原則，請使用 IVdsServiceSAN：：SetSANPolicy 方法。

此列舉會取代 NoAutoMount 登錄機碼，可在下列登錄路徑下找到：

\ HKEY_LOCAL_MACHINE系統\CurrentControlSet\服務\Mountmgr\NoAutoMount

此機碼的值是設定為 0x00000000 REG_DWORD 值，以啟用 Windows 自動掛接功能或非零值來停用它。 如果已啟用自動掛接功能，Windows 會在將檔案系統新增至系統時自動掛接新的基本磁碟區，然後將驅動器號指派給磁碟區。 在系統局域網路設定中，停用自動掛接可防止 Windows 自動掛接或指派驅動器號給任何新增至系統的新基本磁碟區。

在 Windows Server 2016 上，預設 SAN 原則會VDS_SP_OFFLINE_SHARED。 這適用於所有版本和安裝類型，包括 Nano Server。

在 Windows Server 2008 Enterprise 和 Windows Server 2008 Datacenter 上，預設 SAN 原則為 VDS_SP_OFFLINE_SHARED。 在所有其他 Windows Server 2008 版本上，預設 SAN 原則會 VDS_SP_ONLINE。

針對從舊版 Windows 升級，如果在升級之前設定 NoAutoMount 登錄機碼，升級將會清除此登錄機碼，並將 SAN 原則設定為 VDS_SP_OFFLINE_SHARED。 (Windows Server 2008 Enterprise 和 Windows Server 2008 Datacenter 上預設會設定 NoAutoMount 登錄機碼。) 如果升級之前未設定 NoAutoMount 登錄機碼，升級會將 SAN 原則設定為 VDS_SP_ONLINE。 此外，升級會檢查每個磁碟，以判斷磁碟上的磁碟區是在線還是脫機。 如果磁碟在升級之前處於在線狀態，而且有一或多個在線磁碟區，則不論 SAN 原則或磁碟是否位於共用總線上，升級都會讓該磁碟及其所有磁碟區上線。 例如，假設具有兩個離線磁碟區和一個線上磁碟區的在線磁碟位於共用總線上，並在升級之前設定 NoAutoMount 登錄機碼。 升級之後，SAN 原則將會 VDS_SP_OFFLINE_SHARED、磁碟會上線，而且這三個磁碟區都會上線。

針對 Windows 的全新安裝，SAN 原則會決定磁碟在安裝 Windows 之後是否在在線或離線。

注意 未來 Windows 版本中可能會將其他常數新增至 VDS_SAN_POLICY 列舉。 基於這個理由，您的應用程式必須設計為正常處理無法辨識 的VDS_SAN_POLICY 列舉常數。
 

規格需求

需求 值
最低支援的用戶端 Windows Vista SP1 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
標頭 vds.h

另請參閱

IVdsServiceSAN：：GetSANPolicy

IVdsServiceSAN：：SetSANPolicy