SHSetDefaultProperties 函数 (shobjidl.h)
在 Shell 项上应用默认的属性集。
语法
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 |