IFileSystemImage2::p ut_BootImageOptionsArray メソッド (imapi2fs.h)
ファイル システム イメージの生成に使用されるブート オプション配列を設定します。 IFileSystemImage::p ut_BootImageOptions とは異なり、このメソッドは各ブート オプション配列要素の完全なコピーを作成するのではなく、代わりに各要素への参照を使用します。
構文
HRESULT put_BootImageOptionsArray(
[in] SAFEARRAY *newVal
);
パラメーター
[in] newVal
ファイル システム イメージの生成に使用されるブート イメージの IBootOptions インターフェイスの一覧。 リストの各要素は、VT_DISPATCH型の VARIANT です。
戻り値
S_OKは成功時に返されますが、実装の結果として他の成功コードが返される場合があります。 次のエラー コードは通常、操作の失敗時に返されますが、考えられる唯一のエラー値を表すわけではありません。
リターン コード | 説明 |
---|---|
|
そのようなインターフェイスはサポートされていません。
値: 0x80004002 |
|
ブート オブジェクトは、初期ディスク イメージにのみ含めることができます。
値: 0xC0AAB149 |
|
ブート オブジェクトをイメージに追加できませんでした。
値: 0xC0AAB148 |
注釈
SAFEARRAY は 1 次元配列である必要があります。 0 サイズの配列を使用できますが、通常の起動不可能なディスクになります。
ディスク上のブート イメージ シーケンスは、 SAFEARRAY で指定されたシーケンスと一致します。 ブート イメージの指定には 、put_BootImageOptionsArray と put_BootImageOptions の両方が使用されます。後者の関数は、作成されたディスク イメージが有効になる前に呼び出されます。
get_BootImageOptionsArray関数とget_BootImageOptions関数は、put_BootImageOptionsArrayまたはput_BootImageOptionsの最後の呼び出しの結果を取得します。 これらの関数の使用は同期する必要があります。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista と SP1 [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | imapi2fs.h |