IVdsCreatePartitionEx
COM公式ドキュメント
ベーシックディスク上にパーティションを作成します。
メソッド 1
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
ベーシックディスク上にパーティションを作成します。このメソッドは IVdsAdvancedDisk::CreatePartition メソッドに代わるものです。
| ullOffset | ULONGLONG | in | パーティションのオフセット(バイト単位)。オフセットがアラインメントされておらず、ulAlign パラメーターも指定されていない場合、オフセットはパーティションが作成されるディスクのサイズに応じて、最も近いアラインメント境界に切り上げまたは切り下げられます。詳細については、以下の「解説」セクションを参照してください。 Windows Server 2003: ベーシックディスク上でアラインメントできるのは最初のパーティションのみで、ダイナミックディスクはアラインメントできません。ベーシックディスク上のその他のパーティションでは、ulAlign パラメーターを使用してアラインメントを指定することはできません。オフセットは、Master Boot Record (MBR) ディスクの場合は最も近いシリンダー境界に、GUID Partition Table (GPT) ディスクの場合は最も近いセクター境界に丸められます。 呼び出し元が ullOffset パラメーターと ulAlign パラメーターの両方を指定する場合、オフセットは最初のシリンダー内に収まる必要があります。 |
| ullSize | ULONGLONG | in | 新しいパーティションのサイズ(バイト単位)。 |
| ulAlign | DWORD | in | アラインメントのサイズ(バイト単位)。 Windows Server 2003: このパラメーターが指定されている場合、プロバイダーはパーティションのオフセットを最も近いアラインメント境界に切り上げます。指定されていない場合は、最も近いシリンダー境界に切り上げます。 ディスクの先頭にパーティションサイズを収めるのに十分な領域があり、ulAlign パラメーターが指定されているが ullOffset パラメーターが指定されていない場合、CreatePartitionEx の呼び出しは失敗します。 |
| para | CREATE_PARTITION_PARAMETERS* | in | CREATE_PARTITION_PARAMETERS 構造体で定義されるパラメーターへのポインター。 |
| ppAsync | IVdsAsync** | out | IVdsAsync インターフェイスポインターのアドレス。VDS は戻り時にこれを初期化します。呼び出し元はこのインターフェイスを解放する必要があります。このポインターを使用して、操作のキャンセル、完了待ち、または状態の照会を行います。 |
戻り値
このメソッドは、E_INVALIDARG や E_OUTOFMEMORY などの標準的な HRESULT 値、および VDS 固有の戻り値 を返すことがあります。また、HRESULT_FROM_WIN32 マクロを使用して変換された システムエラーコード を返すこともあります。エラーは、VDS 自体、または使用されている基盤の VDS プロバイダー から発生する可能性があります。返される可能性のある値には次のものがあります。
| リターンコード/値 | 説明 |
|---|---|
| パーティションが正常に作成されました。 | |
|
リムーバブルドライブにメディアがありません。 |
|
ディスクが読み取り専用のため、パーティションを作成できませんでした。 |
|
メディアがこの操作をサポートしていません。たとえば、呼び出し元は CD-ROM 上にパーティションを作成できません。 |
|
リムーバブルメディア上に2つ目のパーティションを作成することはサポートされていません。または、このエラーはディスクがダイナミックディスクであることを示します。 |
|
呼び出し元が追加のプライマリパーティションまたは拡張パーティションを作成しようとしたときに、パーティションの最大数(プライマリパーティション、またはプライマリパーティションと拡張パーティション)が既に存在しています。 |
|
パーティションは正常に作成されましたが、VDS はブート構成データ (BCD) ストア内のブートオプションの更新に失敗しました。
Windows Server 2003: ブートオプションは、x86 または x64 システムでは boot.ini ファイルに、Itanium システムでは NVRAM に格納されます。 |
解説(Remarks)
このメソッドは、GPT または MBR のいずれかのパーティション方式を持つベーシックディスクに対して動作します。
Windows Server 2003: 呼び出し元がアラインメントできるのは MBR ディスクの最初のパーティションのみであり、開始オフセットは最初のシリンダー内、または2番目のシリンダーの先頭の、シリンダー境界に配置する必要があります。
ullOffset パラメーターが指定されており、その値が HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\Vds\Alignment レジストリサブキーの値を使用してまだアラインメントされていない場合、その値は次の値を使用して自動的にアラインメントされます。既定のアラインメントは、ディスクが 4 GB 以上の場合は 1 MB、ディスクが 4 GB 未満の場合は 64 KB です。
Windows Server 2003: アラインメントされていないパーティションオフセットは、MBR ディスクの場合は最も近いシリンダー境界に、GPT ディスクの場合は最も近いセクター境界に丸められます。
ダイナミックディスクが読み取り専用かつオフラインの場合、CreatePartitionEx を呼び出す前に、次の手順で読み取り/書き込み可能にしてオンラインにする必要があります。
- 読み取り専用ビットをクリアします。(これは VDS_DISK_PROP 構造体の VDS_DF_READ_ONLY フラグです。)
- IVdsDiskOnline::Online メソッドを呼び出します。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IVdsCreatePartitionEx "{9882F547-CFC3-420B-9750-00DFBEC50662}" #usecom global IVdsCreatePartitionEx IID_IVdsCreatePartitionEx "{}" #comfunc global IVdsCreatePartitionEx_CreatePartitionEx 3 int64,int64,int,var,sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IVdsCreatePartitionEx "{9882F547-CFC3-420B-9750-00DFBEC50662}" #usecom global IVdsCreatePartitionEx IID_IVdsCreatePartitionEx "{}" #comfunc global IVdsCreatePartitionEx_CreatePartitionEx 3 int64,int64,int,sptr,sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。