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