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 |