IFileSaveDialog_ApplyProperties

シェルのコピーエンジンを使って一連のプロパティをアイテムに適用する。

IFileSaveDialog_ApplyProperties this, psi, pStore, hwnd, pSink

this : [comobj] IFileSaveDialog インターフェースの COM オブジェクト変数
psi : [comobj] 型: IShellItem* 保存されるファイルを表す IShellItem へのポインター。通常これは GetResult で取得したアイテムである。
pStore : [comobj] 型: IPropertyStore* ファイルに適用されるプロパティ値を表す IPropertyStore へのポインター。これは IFileSaveDialog::GetProperties が返したプロパティストアでもよい。
hwnd : [intptr] 型: HWND アプリケーションウィンドウのハンドル。
pSink : [comobj] 型: IFileOperationProgressSink* 呼び出し側アプリケーションがプロパティの書き込み進捗の通知を受けたい場合に使用できる任意の IFileOperationProgressSink へのポインター。この値は NULL でもよい。

(プラグイン / モジュール : com_misc.dll)

解説

シェルのコピーエンジンを使って一連のプロパティをアイテムに適用する。

[戻り値]
型: HRESULT このメソッドが成功した場合 S_OK を返す。そうでなければ HRESULT エラーコードを返す。

[備考]

このメソッドは、アプリケーションがプロパティ収集を有効にしている（IFileSaveDialog::SetCollectedProperties）が、プロパティ自体を保存済みファイルに永続化していない場合に使用すべきである。注意
psi で指定したアイテムが表すファイルは、IFileSaveDialog::ApplyProperties
の呼び出し前に物理ストレージ上に存在していなければならない。つまり事前にどこかで保存されている必要がある。

情報