IFileOperationProgressSink：:P ostNewItem 方法 (shobjidl_core.h)

创建新项后，执行调用方实现的操作。

语法

HRESULT PostNewItem(
  [in] DWORD      dwFlags,
  [in] IShellItem *psiDestinationFolder,
  [in] LPCWSTR    pszNewName,
  [in] LPCWSTR    pszTemplateName,
  [in] DWORD      dwFileAttributes,
  [in] HRESULT    hrNew,
  [in] IShellItem *psiNewItem
);

参数

[in] dwFlags

类型：DWORD

包含创建操作期间使用的标志的按位值。 某些值可以在创建操作期间设置或更改。 有关标志说明，请参阅 TRANSFER_SOURCE_FLAGS 。

[in] psiDestinationFolder

类型： IShellItem*

指向 IShellItem 的指针，该 IShellItem 指定要向其添加新项的目标文件夹。

[in] pszNewName

类型： LPCWSTR

指向新项的文件名的指针，例如 Newfile.txt。 这是以 null 结尾的 Unicode 字符串。

[in] pszTemplateName

类型： LPCWSTR

指向模板文件名称的指针 (例如 Excel9.xls 新项所基于的) ，存储在以下位置之一：

• CSIDL_COMMON_TEMPLATES。 此文件夹的默认路径为 %ALLUSERSPROFILE%\Templates。
• CSIDL_TEMPLATES。 此文件夹的默认路径为 %USERPROFILE%\Templates。
• %SystemRoot%\shellnew

这是一个以 null 结尾的 Unicode 字符串，用于指定与新文件类型相同的现有文件，其中包含应用程序希望包含在任何新文件中的最少内容。

此参数通常为 NULL ，用于指定新的空白文件。

[in] dwFileAttributes

类型：DWORD

应用于新项的文件属性。 在 GetFileAttributes 中找到的一个或多个值。

[in] hrNew

类型： HRESULT

创建操作的返回值。 请注意，这不是 NewItem 返回的 HRESULT，它只是将创建操作排入队列。 相反，这是实际创建的结果。

[in] psiNewItem

类型： IShellItem*

指向表示新项的 IShellItem 的指针。

返回值

类型： HRESULT

如果成功，则返回 S_OK，否则返回错误值。 如果出现错误值，将取消从调用 IFileOperation 挂起的所有后续操作。

要求

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