IVdsAdvancedDisk::CreatePartition メソッド (vds.h)

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

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

このメソッドは 、IVdsCreatePartitionEx::CreatePartitionEx メソッドよりも優先されます。

構文

HRESULT CreatePartition(
  [in]  ULONGLONG                   ullOffset,
  [in]  ULONGLONG                   ullSize,
  [in]  CREATE_PARTITION_PARAMETERS *para,
  [out] IVdsAsync                   **ppAsync
);

パラメーター

[in] ullOffset

パーティション オフセット。

[in] ullSize

新しいパーティションのサイズ (バイト単位)。

[in] para

CREATE_PARTITION_PARAMETERS構造体によって定義されるパラメーターへのポインター。

[out] ppAsync

戻り時に VDS が初期化する IVdsAsync インターフェイス ポインターのアドレス。 呼び出し元はインターフェイスを解放する必要があります。 操作の状態をキャンセル、待機、またはクエリするには、このポインターを使用します。

戻り値

このメソッドは、E_INVALIDARGやE_OUTOFMEMORYなどの標準の HRESULT 値と、 VDS 固有の戻り値を返すことができます。 また、HRESULT_FROM_WIN32 マクロを使用して、変換されたシステム エラー コードを返すこともできます。 エラーは、VDS 自体または使用されている基になる VDS プロバイダー から発生する可能性があります。 可能な戻り値は次のとおりです。

リターン コード/値 説明
S_OK
パーティションが正常に作成されました。
VDS_E_NO_MEDIA
0x80042412L
リムーバブル ドライブにはメディアがありません。
VDS_E_INVALID_OPERATION
0x80042415L
メディアはこの操作をサポートしていません。 たとえば、呼び出し元は CD-ROM にパーティションを作成できません。
VDS_E_NOT_SUPPORTED
0x80042400L
リムーバブル メディアでの 2 つ目のパーティションの作成はサポートされていません。 または、このエラーは、ディスクが動的ディスクであることを示します。
VDS_E_PARTITION_LIMIT_REACHED
0x80042407L
呼び出し元が追加のプライマリ パーティションまたは拡張パーティションを作成しようとしたときに、パーティションの最大数 (4 つのプライマリ、または 3 つのプライマリと 1 つの拡張) が既に存在します。
VDS_S_UPDATE_BOOTFILE_FAILED
0x00042434L
パーティションは正常に作成されましたが、VDS はブート構成データ (BCD) ストアのブート オプションを更新できませんでした。

Windows Server 2003: ブート オプションは、itanium システムの x86 または x64 システムまたは NVRAM のboot.ini ファイルに格納されます。

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー vds.h
Library Uuid.lib

関連項目

CREATE_PARTITION_PARAMETERS

Disk オブジェクト

IVdsAdvancedDisk

IVdsAsync

IVdsCreatePartitionEx::CreatePartitionEx