VDS_VOLUME_FLAG列舉 (vds.h)

  • 發行項

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

定義磁碟區物件的一組有效旗標。

Syntax

typedef enum _VDS_VOLUME_FLAG {
  VDS_VF_SYSTEM_VOLUME = 0x1,
  VDS_VF_BOOT_VOLUME = 0x2,
  VDS_VF_ACTIVE = 0x4,
  VDS_VF_READONLY = 0x8,
  VDS_VF_HIDDEN = 0x10,
  VDS_VF_CAN_EXTEND = 0x20,
  VDS_VF_CAN_SHRINK = 0x40,
  VDS_VF_PAGEFILE = 0x80,
  VDS_VF_HIBERNATION = 0x100,
  VDS_VF_CRASHDUMP = 0x200,
  VDS_VF_INSTALLABLE = 0x400,
  VDS_VF_LBN_REMAP_ENABLED = 0x800,
  VDS_VF_FORMATTING = 0x1000,
  VDS_VF_NOT_FORMATTABLE = 0x2000,
  VDS_VF_NTFS_NOT_SUPPORTED = 0x4000,
  VDS_VF_FAT32_NOT_SUPPORTED = 0x8000,
  VDS_VF_FAT_NOT_SUPPORTED = 0x10000,
  VDS_VF_NO_DEFAULT_DRIVE_LETTER = 0x20000,
  VDS_VF_PERMANENTLY_DISMOUNTED = 0x40000,
  VDS_VF_PERMANENT_DISMOUNT_SUPPORTED = 0x80000,
  VDS_VF_SHADOW_COPY = 0x100000,
  VDS_VF_FVE_ENABLED = 0x200000,
  VDS_VF_DIRTY = 0x400000,
  VDS_VF_REFS_NOT_SUPPORTED = 0x800000,
  VDS_VF_BACKS_BOOT_VOLUME = 0x1000000,
  VDS_VF_BACKED_BY_WIM_IMAGE = 0x2000000
} VDS_VOLUME_FLAG;

常數

 
VDS_VF_SYSTEM_VOLUME
值： 0x1
磁碟區是系統磁碟區。
VDS_VF_BOOT_VOLUME
值： 0x2
磁碟區是開機磁碟區。
VDS_VF_ACTIVE
值： 0x4
磁碟區為使用中。 也就是說， 的 bootIndicator 值
基礎分割區設定為 true。
VDS_VF_READONLY
值： 0x8
磁碟區具有驅動器號和掛接管理員指派的磁碟區 GUID 名稱，並由 FindFirstVolume 和 FindNextVolume 函式列舉。 不過，磁碟區是唯讀的。 此旗標不適用於CD-ROM或 DVD 裝置。
VDS_VF_HIDDEN
值： 0x10
磁碟區沒有驅動器號和掛接管理員指派的磁碟區 GUID 名稱。 FindFirstVolume 和 FindNextVolume 函式不會列舉磁碟區。 磁碟區可以使用其裝置名稱來開啟，而且可以讀取或寫入已開啟的磁碟區。 磁碟區裝置名稱的範例為 \？\GLOBALROOT\Device\HarddiskVolumeX。 此旗標不適用於CD-ROM或 DVD 裝置。
VDS_VF_CAN_EXTEND
值： 0x20
可以擴充磁碟區大小。
VDS_VF_CAN_SHRINK
值： 0x40
磁碟區大小可以減少。
VDS_VF_PAGEFILE
值： 0x80
磁碟區包含頁面檔。
VDS_VF_HIBERNATION
值： 0x100
磁碟區包含休眠檔案。
VDS_VF_CRASHDUMP
值： 0x200
磁碟區包含損毀傾印檔案。
VDS_VF_INSTALLABLE
值： 0x400
VDS 會在動態磁碟區下建立硬式分割區，讓呼叫端可用來安裝操作系統。 清除此旗標會導致刪除分割區。 此旗標只能針對動態磁碟設定或清除;它一律會設定為基本磁碟。 此旗標不適用於CD-ROM或 DVD 裝置。
VDS_VF_LBN_REMAP_ENABLED
值： 0x800
VDS 可以動態變更磁碟上磁碟區的位置。 此旗標對基本無效
或動態磁碟區，只有某些第三方磁碟區管理員才支援。
VDS_VF_FORMATTING
值： 0x1000
正在格式化磁碟區。
VDS_VF_NOT_FORMATTABLE
值： 0x2000
無法格式化磁碟區。 此旗標適用於小型可攜式記憶體裝置，可移動裝置
裝置、CDROM 裝置和 DVD 裝置。 針對 CD 和 DVD 裝置，這一律會在 有媒體時設定
磁碟驅動器，如果磁碟驅動器中沒有媒體，則不會設定 。
VDS_VF_NTFS_NOT_SUPPORTED
值： 0x4000
磁碟區不支援NTFS，但可支援其他檔案系統。 此旗標適用於小型
可攜式記憶體裝置、卸載式裝置、CDROM 裝置和 DVD 裝置。
VDS_VF_FAT32_NOT_SUPPORTED
值： 0x8000
磁碟區不支援 FAT32。 此旗標適用於小型可攜式記憶體裝置，可移動裝置
裝置、CDROM 裝置和 DVD 裝置。
VDS_VF_FAT_NOT_SUPPORTED
值： 0x10000
磁碟區不支援 FAT。 此旗標適用於小型可攜式記憶體裝置，可移動裝置
裝置、CDROM 裝置和 DVD 裝置。
VDS_VF_NO_DEFAULT_DRIVE_LETTER
值： 0x20000
下次將磁碟區新增至計算機時，操作系統不會自動指派驅動器號。
如果清除，操作系統會在某些情況下將驅動器號指派給磁碟區。 針對基本 GPT
磁碟區，指派或移除驅動器號將會切換此旗標。 此旗標不適用於CD-ROM或 DVD 裝置。

Windows Server 2003： 在動態磁碟區上，一律會設定此旗標，而且無法清除。 在基本磁碟區上，預設會加以清除，而且只能藉由呼叫 IVdsVolume：：SetFlags 或 IVdsVolume：：ClearFlags 方法來設定或清除。
VDS_VF_PERMANENTLY_DISMOUNTED
值： 0x40000
磁碟區已離線。 磁碟區開啟會在離線磁碟區上成功。 不過，針對離線磁碟區的 I/O 將會失敗。 將存取路徑，例如驅動器號指派給離線磁碟區會導致它變成在線。 若要設定此旗標，請呼叫 IVdsVolumeMF：:D ismount
方法，將 bForce 和 bPermanent 參數設定為
TRUE： 此旗標不適用於CD-ROM或 DVD 裝置。

Windows Server 2003： 不支援大綱動態磁碟區。

當磁碟區脫機時，此旗標會在VDS_VOLUME_PROP 結構的ulFlags成員中設定，而VDS_VS_OFFLINE旗標也會在VDS_VOLUME_PROP或VDS_VOLUME_PROP2結構的狀態成員中設定。Windows Server 2008、Windows Vista 和 Windows Server 2003： 不支援VDS_VS_OFFLINE旗標。
VDS_VF_PERMANENT_DISMOUNT_SUPPORTED
值： 0x80000
磁碟區可以脫機。
VDS_VF_SHADOW_COPY
值： 0x100000
磁碟區是另一個磁碟區的陰影複製。 建立陰影複製時會設定此旗標。 這是
從原始磁碟區中斷陰影複製時清除。 VDS_VF_SHADOW_COPY
flag 是文件系統篩選驅動程式型軟體 (的指示，例如
防毒程式) 以避免附加至
磁碟區。 應用程式可以使用 屬性來區分陰影複製磁碟區與生產磁碟區。 應用程式
執行「快速復原」，其中陰影複製 LUN 會清除唯讀和隱藏，以將陰影複製 LUN 設為非陰影複製
bit 也需要清除這個位。 此旗標不適用於CD-ROM或 DVD 裝置。


Windows Server 2003： Windows Server 2003 SP1 之前不支援此旗標。
VDS_VF_FVE_ENABLED
值： 0x200000
磁碟區受到 BitLocker 完整磁碟區加密的保護。 此旗標不適用於CD-ROM或 DVD 裝置。

Windows Server 2003： 不支援此旗標。
VDS_VF_DIRTY
值： 0x400000
已設定磁碟區的中途位。

Windows Server 2003： 不支援此旗標。
VDS_VF_REFS_NOT_SUPPORTED
值： 0x800000
VDS_VF_BACKS_BOOT_VOLUME
值： 0x1000000
VDS_VF_BACKED_BY_WIM_IMAGE
值： 0x2000000

備註

在 MBR 基本磁碟上，磁碟區旗標只能針對整個磁碟設定，而不是針對個別磁碟區設定。

如果在 MBR 磁碟上設定 VDS_VF_NO_DEFAULT_DRIVE_LETTER 旗標，則會保留任何現有的驅動器號，但不會將新的驅動器號指派給磁碟上的磁碟區。

此列舉提供VDS_VOLUME_PROP結構之 ulFlags 成員的值，以及 IVdsVolume：：SetFlags 和 IVdsVolume：：ClearFlags 方法的 ulFlags 參數。

下表比較 MBR 基本磁碟、GPT 基本磁碟和動態磁碟上VDS_VF_NO_DEFAULT_DRIVE_LETTER旗標的行為。

功能 MBR 基本磁碟 GPT 基本磁碟 MBR 或 GPT 動態磁碟
預設會清除VDS_VF_NO_DEFAULT_DRIVE_LETTER旗標。 不過，您可以呼叫 IVdsVolume：：SetFlags 來設定此旗標。 可以。 可以。 是的。Windows Server 2003： 此旗標一律會設定為動態磁碟，而且無法清除。
指派或移除驅動器號會切換VDS_VF_NO_DEFAULT_DRIVE_LETTER旗標設定。 否，因為已針對整個磁碟設定或清除此旗標。 是，因為已針對個別磁碟區設定或清除此旗標。 是的。Windows Server 2003： 此旗標一律會設定為動態磁碟，而且無法清除。
 

若要在動態磁碟上建立開機磁碟區，您必須設定 磁碟區的VDS_VF_INSTALLABLE 旗標，然後呼叫 IVdsVolumeMF：：Format 方法來格式化磁碟區。

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

規格需求

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

另請參閱

IVdsVolume：：ClearFlags

IVdsVolume：：SetFlags

IVdsVolumeMF：:D ismount

VDS 列舉

VDS_PARTITION_INFO_MBR

VDS_SAN_POLICY

VDS_VOLUME_PROP