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