IFileOperation：：NewItem 方法 (shobjidl_core.h)

  • 项目

声明将在指定位置创建的新项。

语法

HRESULT NewItem(
  [in] IShellItem                 *psiDestinationFolder,
  [in] DWORD                      dwFileAttributes,
  [in] LPCWSTR                    pszName,
  [in] LPCWSTR                    pszTemplateName,
  [in] IFileOperationProgressSink *pfopsItem
);

参数

[in] psiDestinationFolder

类型： IShellItem*

指向 IShellItem 的指针，该 IShellItem 指定将包含新项的目标文件夹。

[in] dwFileAttributes

类型：DWORD

一个按位值，指定文件或文件夹的文件系统属性。 有关可能的值 ，请参阅 GetFileAttributes 。

[in] pszName

类型： 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] pfopsItem

类型： IFileOperationProgressSink*

指向要用于状态和失败通知的 IFileOperationProgressSink 对象的指针。 如果为整个操作调用 IFileOperation：：Advise ，则会包含创建操作的进度状态和错误通知，因此请将此参数设置为 NULL。

返回值

类型： HRESULT

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

注解

此方法不会创建新项，而只是声明要创建的项。 若要创建新项，必须至少进行此处详述的调用序列：

  1. 调用 IFileOperation：：NewItem 以声明新文件或文件夹的具体信息。
  2. 调用 IFileOperation：:P erformOperations 以创建新项。

要求

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

另请参阅

IFileOperation

PostNewItem

PreNewItem