IFileSaveDialog：：ApplyProperties 方法 (shobjidl_core.h)

使用 Shell 的复制引擎将一组属性应用于项。

语法

HRESULT ApplyProperties(
  [in] IShellItem                 *psi,
  [in] IPropertyStore             *pStore,
  [in] HWND                       hwnd,
  [in] IFileOperationProgressSink *pSink
);

参数

[in] psi

类型： IShellItem*

指向表示要保存的文件的 IShellItem 的指针。 这通常是 GetResult 检索到的项。

[in] pStore

类型： IPropertyStore*

指向表示要应用于文件的属性值的 IPropertyStore 的指针。 这可以是 IFileSaveDialog：：GetProperties 返回的属性存储。

[in] hwnd

类型：HWND

应用程序窗口的句柄。

[in] pSink

类型： IFileOperationProgressSink*

指向可选 IFileOperationProgressSink 的指针，调用应用程序可以使用该指针，如果它们想要收到属性标记进度的通知。 此值可以为 NULL。

返回值

类型： HRESULT

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

当应用程序打开属性集合 (IFileSaveDialog：：SetCollectedProperties) ，但不将属性本身保存到保存的文件中时，应使用此方法。

注意在调用 IFileSaveDialog：：ApplyProperties 之前，由 psi 中指定的项表示的文件必须存在于物理存储中，因此它之前必须已保存在某个时间点。

 

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
目标平台	Windows
标头	shobjidl_core.h