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.AuthorSystem.Document.DateCreatedSystem.Photo.DateTaken。 如果 ProgID 上不存在 SetDefaultsFor 条目,则此函数使用在 HKEY_CLASSES_ROOT\*SetDefaultsFor 条目上找到的默认值。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 shobjidl.h
Library Shell32.lib
DLL Shell32.dll