SHSetDefaultProperties 関数 (shobjidl.h)
シェル 項目にプロパティの既定のセットを適用します。
構文
SHSTDAPI SHSetDefaultProperties(
[in, optional] HWND hwnd,
[in] IShellItem *psi,
DWORD dwFileOpFlags,
[in, optional] IFileOperationProgressSink *pfops
);
パラメーター
[in, optional] hwnd
型: HWND
アイテムの親ウィンドウへのハンドル。エラー通知を受け取ります。 この値は NULL にすることができます。
[in] psi
種類: IShellItem*
アイテムを表す IShellItem オブジェクトへのポインター。
dwFileOpFlags
型: DWORD
操作をカスタマイズするフラグ。 フラグ値については、「 IFileOperation::SetOperationFlags 」を参照してください。
[in, optional] pfops
種類: IFileOperationProgressSink*
操作の進行状況に従うために使用される IFileOperationProgressSink オブジェクトへのポインター。 詳細については、「 IFileOperation::Advise 」を参照してください。 この値は NULL にすることができます。
戻り値
種類: HRESULT
この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。
解説
既定値を設定するプロパティの一覧は、項目のファイル関連付けの ProgID の 下にある SetDefaultsFor レジストリ エントリから取得されます。 リストの先頭には "prop:
" が付き、既定値を設定するプロパティの正規名が含まれています (例: "prop:System.Author;System.Document.DateCreated
)。 このリストで使用できるプロパティは、 System.Author、 System.Document.DateCreated、 System.Photo.DateTaken です。 ProgID に SetDefaultsFor エントリが存在しない場合、この関数は HKEY_CLASSES_ROOT の SetDefaultsFor エントリにある既定値を\*使用します。
要件
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | shobjidl.h |
Library | Shell32.lib |
[DLL] | Shell32.dll |