VDS_VOLUME_FLAG 列挙 (vds.h)

[アーティクル]
03/08/2023

[Windows 8とWindows Server 2012以降、仮想ディスクサービス COM インターフェイスは Windows Storage Management API に置き換えられます。

ボリュームオブジェクトの有効なフラグのセットを定義します。

構文

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 は、ディスク上のボリュームの位置を動的に変更できます。このフラグは Basic では無効ですまたは動的ボリューム。は、一部のサードパーティ製ボリュームマネージャーでのみサポートされています。
`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_VOLUME_PROPまたはVDS_VOLUME_PROP2構造体の状態メンバーにもVDS_VS_OFFLINEフラグが設定されます。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 フラグは、ファイルシステムフィルタードライバーベースのソフトウェア (例: ウイルス対策プログラム)へのアタッチを避けるために、のフォーマットを実行します。この属性は、シャドウコピーボリュームと運用ボリュームを区別するためにアプリケーションで使用できます。アプリケーション読み取り専用と非表示をクリアすることで、シャドウコピー LUN が非シャドウコピーに作成される高速回復を実行するビットもこのビットをクリアする必要があります。このフラグは、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 ベーシックディスクでは、ボリュームフラグは個々のボリュームではなく、ディスク全体に対してのみ設定できます。

VDS_VF_NO_DEFAULT_DRIVE_LETTER フラグが MBR ディスクに設定されている場合、既存のドライブ文字は保持されますが、ディスク上のボリュームには新しいドライブ文字は割り当てされません。

この列挙体は、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 (デスクトップアプリのみ)
Header	vds.h