IVdsPack::AddDisk メソッド (vds.h)

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

オンライン パックにディスクを追加します。

構文

HRESULT AddDisk(
  [in] VDS_OBJECT_ID       DiskId,
  [in] VDS_PARTITION_STYLE PartitionStyle,
  [in] BOOL                bAsHotSpare
);

パラメーター

[in] DiskId

ディスクの GUID。

[in] PartitionStyle

スタイルには MBR または GPT を指定できます。 VDS_PARTITION_STYLE列挙を参照してください。

[in] bAsHotSpare

true の場合、VDS はホット スペアとしてディスクを使用できます。それ以外の場合は、この操作にディスクを使用できません。 ホット スペーリングをサポートするのは、ハードウェア プロバイダーのみです。

戻り値

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

注釈

VDS はこのメソッドを実装します。

このメソッドは、生ディスク (パーティション分割が定義されていないディスク) を初期化し、パックに追加します。 このメソッドが呼び出される前に、生ディスクは VDS サービスによって所有されます。 このメソッドが返された後、ディスクは基本プロバイダーによって所有されます。

このメソッドの効果を元に戻すには (つまり、パーティション分割形式を削除し、ディスクを VDS サービスが所有する未加工のディスクにする) には、 IVdsAdvancedDisk::Clean メソッドを使用します。

AddDisk を使用して、既存のディスク上のパーティション分割を再定義することはできません。

GPT ディスクを基本パックに追加すると、操作によってディスク上に MSR パーティションが自動的に作成されます。 管理者がディスク上に ESP パーティションを作成する場合があるため、WinPE オペレーティング システムを実行しているデバイスは例外です。 ESP パーティションが存在する場合は、ディスク上の最初のパーティションである必要があります。

ディスクを動的パックに追加した場合、操作では MSR パーティションは作成されません。

要件

こちらもご覧ください

IVdsPack

VDS_PACK_PROP

VDS_PARTITION_STYLE