次の方法で共有

MSFT_Disk クラスの CreatePartition メソッド

  • [アーティクル]

ディスクにパーティションを作成します。

構文

UInt32 CreatePartition(
  [in]  UInt64  Size,
  [in]  Boolean UseMaximumSize,
  [in]  UInt64  Offset,
  [in]  UInt32  Alignment,
  [in]  Char16  DriveLetter,
  [in]  Boolean AssignDriveLetter,
  [in]  UInt16  MbrType,
  [in]  String  GptType,
  [in]  Boolean IsHidden,
  [in]  Boolean IsActive,
  [out] String  CreatedPartition,
  [out] String  ExtendedStatus
);

パラメーター

Size [in]

パーティションに必要なサイズ (バイト単位)。 これは、ディスクの LargestFreeExtent プロパティで指定されたサイズ以下である必要があります。 このパラメーターは、UseMaximumSize と一緒に使用することはできません。

UseMaximumSize [in]

TRUE の場合、パーティションはディスク上の最大の空きエクステントを埋めます。 このパラメーターは、Sizeパラメーターと一緒に使用することはきません。

Offset [in]

パーティション オフセット (バイト単位)。 オフセットがアラインされておらず、Alignment パラメーターが指定されていない場合、パーティションが作成されるディスクのサイズに応じて、オフセットは最も近い配置境界に切り上げられます。

Alignment [in]

パーティションの配置 (バイト単位)。

DriveLetter [in]

作成時にパーティションに割り当てられるドライブ文字。 このパラメーターは、AssignDriveLetter と一緒に使用することはできません。 両方のパラメーターを指定すると、無効なパラメーター エラーが返されます。 ドライブ文字が使用できない場合、パーティションが作成されますが、エラー '42002' が返されます。

AssignDriveLetter [in]

TRUE の場合、次に使用可能なドライブ文字が作成されたパーティションに割り当てられます。 これ以上ドライブ文字が使用できない場合、パーティションはドライブ文字なしで作成されます。 このパラメーターは、DriveLetter と一緒には使用できません。 両方のパラメーターを指定すると、無効なパラメーター エラーが返されます。

MbrType [in]

MBR パーティションの種類を指定します。 このパラメーターは、ディスクの PartitionStyle プロパティが MBR の場合にのみ設定できます。それ以外の場合はエラーが返されます。 このパラメーターの既定値は Huge です。

Value 意味
FAT12 1 FAT12 ファイル システム パーティション。
FAT16 4 FAT16 ファイル システム パーティション。
Extended 5 拡張パーティション。
Huge 6 巨大なパーティション。 この値は、パーティションに Windows ファイル システムがないことを示します。 論理ボリュームを作成するときは、この値を使用します。
IFS 7 NTFS または ExFAT パーティション。
FAT32 12 FAT32 パーティション。

GptType [in]

GPT 型のパーティション。 このパラメーターは、ディスクの PartitionStyle プロパティが GPT の場合にのみ有効です。それ以外の場合はエラーが返されます。 このパラメーターの既定値は、Basic data です。

Value 意味
システム パーティション c12a7328-f81f-11d2-ba4b-00a0c93ec93b EFI システム パーティション。
Microsoft 予約済み e3c9e316-0b5c-4db8-817d-f92df00215ae Microsoft 予約パーティション。
基本データ ebd0a0a2-b9e5-4433-87c0-68b6b72699c7 基本的なデータ パーティション。 これは、Windows によって作成および認識されるデータ パーティションの種類です。 ドライブ文字の割り当て、ボリューム GUID パスの受信、マウントされたフォルダー (ボリューム マウント ポイントとも呼ばれます) のホストができ、FindFirstVolume と FindNextVolume の呼び出しによって列挙できるのは、この種類のパーティションのみです。
LDM メタデータ 5808c8aa-7e8f-42e0-85d2-e1e90434cfb3 ダイナミック ディスク上の論理ディスク マネージャー (LDM) メタデータ パーティション。
LDM データ af9b60a0-1431-4f62-bc68-3311714a69ad パーティションは、ダイナミック ディスク上の LDM データ パーティションです。
Microsoft リカバリー de94bba4 - 06d1 - 4d40 - a16a - bfd50179d6ac Microsoft 回復パーティション。

IsHidden [in]

TRUE の場合、パーティションはドライブ文字の割り当てを受け取ることができず、マウント マネージャーはボリューム GUID 名を割り当てません。 パーティションは、FindFirstVolume 関数と FindNextVolume 関数では列挙されません。 パーティションは、関連付けられているボリューム デバイス名 ("\\?GLOBALROOT\Device\HarddiskVolumeX" など) で開くことができます。

IsActive [in]

TRUE の場合、パーティションの MBR アクティブ ビットが設定され、パーティションが起動可能になります。 このパラメーターは、MBR ディスクにのみ有効です。

CreatedPartition [out]

作成されたパーティションを表す埋め込み MSFT_Partition オブジェクトを含む文字列。

ExtendedStatus [out]

埋め込み MSFT_StorageExtendedStatus オブジェクトを含む文字列。

このパラメーターを使用すると、ストレージ プロバイダーは拡張 (実装固有の) エラー情報を返すことができます。

戻り値

成功 (0)

サポート非対称 (1)

不明なエラー (2)

タイムアウト (3)

失敗 (4)

無効なパラメーター (5)

ディスクが使用中 (6)

サイズがサポートされていません (4097)

充分な空き領域がありません (40000)

アクセスが拒否されました (40001)

リソース不足のため、操作を完了できません。 (40002)

キャッシュが古くなっています (40003)

Size または UseMaximumSize パラメーターを使用して、サイズを指定する必要があります。 一度に指定できるのは、これらのパラメーターのどちらか 1 つだけです。 (40005)

ディスクが初期化されていません。 (41000)

ディスクは読み取り専用です。 (41002)

ディスクはオフラインです。 (41003)

ディスクのパーティション制限に達しました。 (41004)

指定されたパーティションの配置が無効です。 ディスクのセクター サイズの倍数である必要があります。 (41005)

パラメーターは、この種類のパーティションでは使用できません。 (41006)

指定したパーティションの種類は無効です。 (41010)

MBR ディスクでは、最初の 2 TB のみが使用できます。 (41011)

指定されたオフセットが無効です。 (41012)

デバイスにメディアがありません。 (41015)

指定されたオフセットが無効です。 (41016)

指定されたパーティション レイアウト が無効です。 (41017)

指定されたオブジェクトは、Microsoft フェールオーバー クラスタリング コンポーネントによって管理されます。 この操作を実行するには、ディスクがクラスター メンテナンス モードで、クラスター リソースの状態がオンラインである必要があります。 (41018)

要求されたアクセス パスは既に使用されています。 (42002)

非表示のパーティションにアクセス パスを割り当てることはできません。 (42004)

アクセス パスが有効ではありません。 (42007)

要件

要件 Value
サポートされている最小のクライアント Windows 8 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2012 [デスクトップ アプリのみ]
名前空間 Root\Microsoft\Windows\Storage
MOF Storagewmi.mof

関連項目

MSFT_Disk