CREATE_PARTITION_PARAMETERS構造体 (vds.h)

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

パーティション スタイルのパーティション パラメーターを定義します。

構文

typedef struct _CREATE_PARTITION_PARAMETERS {
  VDS_PARTITION_STYLE style;
  union {
    struct {
      BYTE    partitionType;
      BOOLEAN bootIndicator;
    } MbrPartInfo;
    struct {
      GUID      partitionType;
      GUID      partitionId;
      ULONGLONG attributes;
      WCHAR     name[36];
    } GptPartInfo;
  };
} CREATE_PARTITION_PARAMETERS;

メンバー

style

MbrPartInfo

マスター ブート レコード (MBR) ディスクのパラメーター。 style がVDS_PST_MBRされている場合使用されます。

MbrPartInfo.partitionType

システム定義 MBR パーティションの種類を示します。 使用できる値は次のとおりです。

意味
PARTITION_ENTRY_UNUSED
0x00
未使用のエントリ。
PARTITION_FAT_12
0x01
12 ビット FAT エントリを含むパーティションを指定します。
PARTITION_XENIX_1
0x02
XENIX Type 1 パーティションを指定します。
PARTITION_XENIX_2
0x03
XENIX Type 2 パーティションを指定します。
PARTITION_FAT_16
0x04
16 ビット FAT エントリを含むパーティションを指定します。
PARTITION_EXTENDED
0x05
MS-DOS V4 拡張パーティションを指定します。
PARTITION_HUGE
0x06
MS-DOS V4 巨大パーティションを指定します。 この値は、パーティションに Microsoft ファイル システムがないことを示します。 論理ボリュームを作成する場合は、この値を使用します。
PARTITION_IFS
0x07
NTFS または ExFAT パーティションを指定します。
PARTITION_OS2BOOTMGR
0x0A
OS/2 ブート マネージャー、OPUS、またはコヒーレント スワップ パーティションを指定します。
PARTITION_FAT32
0x0B
FAT32 パーティションを指定します。
PARTITION_FAT32_XINT13
0x0C
この値はサポートされていません。
PARTITION_XINT13
0x0E
この値はサポートされていません。
PARTITION_XINT13_EXTENDED
0x0F
この値はサポートされていません。
PARTITION_PREP
0x41
PowerPC 参照プラットフォーム パーティションを指定します。
PARTITION_LDM
0x42
論理ディスク マネージャー パーティションを指定します。
PARTITION_UNIX
0x63
UNIX パーティションを指定します。
PARTITION_NTFT
0x80
NTFT パーティションを指定します。 この値は、このテーブル内の他の値と組み合わせて使用されます (つまり、ビットごとの論理 ORed)。

MbrPartInfo.bootIndicator

TRUE の場合、パーティションはアクティブであり、起動できます。それ以外の場合、パーティションを使用してシステムを起動することはできません。

GptPartInfo

GUID パーティション テーブル (GPT) ディスクのパラメーター。 styleVDS_PST_GPT場合に使用されます。

GptPartInfo.partitionType

パーティションの種類の GUID。

意味
PARTITION_ENTRY_UNUSED_GUID
00000000-0000-0000-0000-000000000000
パーティションはありません。

この属性は、基本ディスクとダイナミック ディスクに設定できます。

PARTITION_SYSTEM_GUID
c12a7328-f81f-11d2-ba4b-00a0c93ec93b
パーティションは EFI システム パーティションです。

この属性は、基本ディスクとダイナミック ディスクに設定できます。

PARTITION_MSFT_RESERVED_GUID
e3c9e316-0b5c-4db8-817d-f92df00215ae
パーティションは Microsoft の予約済みパーティションです。

この属性は、基本ディスクとダイナミック ディスクに設定できます。

PARTITION_BASIC_DATA_GUID
ebd0a0a2-b9e5-4433-87c0-68b6b72699c7
Windows によって作成および認識されるデータ パーティションの種類。

この種類のパーティションにのみ、ドライブ文字の割り当て、ボリューム GUID パスの受信、マウントされたフォルダーのホスト (ボリューム マウント ポイントとも呼ばれます)、 FindFirstVolumeFindNextVolume の呼び出しによって列挙できます。

この値はベーシック ディスクに対してのみ設定できますが、1 つの例外があります。 PARTITION_BASIC_DATA_GUIDとGPT_ATTRIBUTE_PLATFORM_REQUIREDの両方が、その後ダイナミック ディスクに変換されるベーシック ディスク上のパーティションに対して設定されている場合、そのパーティションは、ディスクの残りの部分がダイナミック ディスクであっても、ベーシック パーティションのままです。 これは、パーティションが GPT ディスク上の OEM パーティションと見なされるためです。

PARTITION_LDM_METADATA_GUID
5808c8aa-7e8f-42e0-85d2-e1e90434cfb3
パーティションは、ダイナミック ディスク上の論理ディスク マネージャー (LDM) メタデータ パーティションです。

この値は、ダイナミック ディスクに対してのみ設定できます。

PARTITION_LDM_DATA_GUID
af9b60a0-1431-4f62-bc68-3311714a69ad
パーティションは、ダイナミック ディスク上の LDM データ パーティションです。

この値は、ダイナミック ディスクに対してのみ設定できます。

PARTITION_MSFT_RECOVERY_GUID
de94bba4-06d1-4d40-a16a-bfd50179d6ac
パーティションは Microsoft 回復パーティションです。

この属性は、ベーシック ディスクとダイナミック ディスクに対して設定できます。

GptPartInfo.partitionId

パーティションの ID の場合。 作成時に GUID_NULL (0) に設定すると、一意の値が生成されます。

GptPartInfo.attributes

パーティションの属性。 これは、次の値のなかから 1 つまたは複数を指定できます。

意味
GPT_ATTRIBUTE_PLATFORM_REQUIRED
0x0000000000000001
この属性が設定されている場合は、コンピューターが正しく機能するためにパーティションが必要です。

たとえば、この属性は OEM パーティションに対して設定する必要があります。 この属性が設定されている場合は、DiskPart.exe ユーティリティを使用して、パーティションの削除などのパーティション操作を実行できることに注意してください。 ただし、パーティションはボリュームではないので、DiskPart.exe ユーティリティを使用してパーティションに対してボリューム操作を実行することはできません。

この属性は、ベーシック ディスクとダイナミック ディスクに対して設定できます。 ベーシック ディスク上のパーティションに対して設定され、ディスクがダイナミック ディスクに変換された場合、ディスクの残りの部分は動的ディスクであっても、パーティションはベーシック パーティションのままです。 これは、パーティションが GPT ディスク上の OEM パーティションと見なされるためです。

GPT_BASIC_DATA_ATTRIBUTE_NO_DRIVE_LETTER
0x8000000000000000
この属性が設定されている場合、ディスクが別のコンピューターに移動されたとき、またはディスクがコンピューターによって初めて表示されるときに、パーティションは既定でドライブ文字を受け取りません。

この属性は、記憶域ネットワーク (SAN) 環境で役立ちます。

その名前にもかかわらず、この属性はベーシック ディスクとダイナミック ディスクに設定できます。

GPT_BASIC_DATA_ATTRIBUTE_HIDDEN
0x4000000000000000
この属性が設定されている場合、パーティションはマウント マネージャーによって検出されません。

その結果、パーティションはドライブ文字を受け取らず、ボリューム GUID パスを受け取らず、マウントされたフォルダー (ボリューム マウント ポイントとも呼ばれます) をホストせず、 FindFirstVolumeFindNextVolume の呼び出しによって列挙されません。 これにより、Disk Defragmenter などのアプリケーションがパーティションにアクセスしないようにします。 ボリューム シャドウ コピー サービス (VSS) では、この属性が使用されます。

その名前にもかかわらず、この属性はベーシック ディスクとダイナミック ディスクに設定できます。

GPT_BASIC_DATA_ATTRIBUTE_SHADOW_COPY
0x2000000000000000
この属性が設定されている場合、パーティションは別のパーティションのシャドウ コピーになります。

この属性は、ボリューム シャドウ コピー サービス (VSS) によって使用されます。 この属性は、ボリュームへのアタッチを回避するために、ファイル システム フィルター ドライバー ベースのソフトウェア (ウイルス対策プログラムなど) を示します。

アプリケーションでは、 属性を使用して、シャドウ コピー ボリュームと実稼働ボリュームを区別できます。 たとえば、高速復旧を実行するアプリケーションでは、読み取り専用属性と非表示属性とこの属性をクリアすることで、シャドウ コピー LUN が中断されます。 この属性は、シャドウ コピーが作成されるときに設定され、シャドウ コピーが破損したときにクリアされます。

その名前にもかかわらず、この属性はベーシック ディスクとダイナミック ディスクに設定できます。

Windows Server 2003: この属性は、Windows Server 2003 SP1 より前はサポートされていません。

GPT_BASIC_DATA_ATTRIBUTE_READ_ONLY
0x1000000000000000
この属性が設定されている場合、パーティションは読み取り専用です。

パーティションへの書き込み要求はすべて失敗します。
IOCTL_DISK_IS_WRITABLE は、ERROR_WRITE_PROTECT Win32 エラー コードで失敗します。これにより、ファイル システムが存在する場合、ファイル システムが読み取り専用としてマウントされます。

VSS では、この属性が使用されます。

ダイナミック ディスクにはこの属性を設定しないでください。 設定すると、I/O エラーが発生し、ファイル システムが正しくマウントされない可能性があります。

GptPartInfo.name[36]

パーティションの名前を指定する Null で終わる Unicode 文字列。

注釈

IVdsAdvancedDisk::CreatePartition メソッドは、この構造体を引数として渡して、パラメーターのセットを指定します。

要件

要件
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
Header vds.h

こちらもご覧ください

IVdsAdvancedDisk::CreatePartition

VDS 構造体

VDS_PARTITION_STYLE