IVdsSwProvider
COM公式ドキュメント
ソフトウェアプロバイダー固有の操作を実行するためのメソッドを提供します。
メソッド 2
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
ソフトウェアプロバイダーが管理するすべてのパックを含む列挙オブジェクトを返します。
| ppEnum | IEnumVdsObject** | out | パックをパックオブジェクトとして列挙するために使用できるIEnumVdsObjectインターフェースポインターのアドレスです。詳細については、列挙オブジェクトの操作を参照してください。呼び出し元は、インターフェースおよび各パックオブジェクトが不要になったら、IUnknown::Releaseメソッドを呼び出して解放する必要があります。 |
戻り値
このメソッドは、E_INVALIDARG や E_OUTOFMEMORY などの標準的な HRESULT 値、およびVDS 固有の戻り値を返すことがあります。また、HRESULT_FROM_WIN32 マクロを使用して変換されたシステムエラーコードを返すこともあります。エラーは、VDS 自体、または使用されている基盤のVDS プロバイダーから発生する可能性があります。返される可能性のある値には次のものが含まれます。
| 戻り値コード | 説明 |
|---|---|
| メソッドは正常に完了しました。 |
パックオブジェクトを作成します。
| ppPack | IVdsPack** | out | IVdsPackインターフェースのアドレスです。呼び出し元はインターフェースを解放する必要があります。 |
戻り値
このメソッドは、E_INVALIDARG や E_OUTOFMEMORY などの標準的な HRESULT 値、およびVDS 固有の戻り値を返すことがあります。また、HRESULT_FROM_WIN32 マクロを使用して変換されたシステムエラーコードを返すこともあります。エラーは、VDS 自体、または使用されている基盤のVDS プロバイダーから発生する可能性があります。返される可能性のある値には次のものが含まれます。
| 戻り値コード/値 | 説明 |
|---|---|
| メソッドは正常に完了しました。 | |
|
VDS_PS_ONLINE 状態の別のダイナミックパックが既に存在します。この状態を持てるダイナミックパックは、一度に 1 つのみです。 |
解説(Remarks)
ディスクのフォーマットを変換するために IVdsPack::MigrateDisks メソッドを呼び出す前に、このメソッドを使用してパックを作成します。ベーシックディスクをダイナミック形式に変換する場合は、新規または既存のパックを MigrateDisks の引数として渡します。ダイナミックディスクをベーシック形式に変換する場合は、CreatePack を使用して、ベーシックディスクを保持する新しい個別のパックを作成します。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IVdsSwProvider "{9AA58360-CE33-4F92-B658-ED24B14425B8}"
#usecom global IVdsSwProvider IID_IVdsSwProvider "{}"
#comfunc global IVdsSwProvider_QueryPacks 3 sptr
#comfunc global IVdsSwProvider_CreatePack 4 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。