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 ,用于指定新的空白文件。
[in] pfopsItem
类型: IFileOperationProgressSink*
指向要用于状态和失败通知的 IFileOperationProgressSink 对象的指针。 如果为整个操作调用 IFileOperation::Advise ,则会包含创建操作的进度状态和错误通知,因此请将此参数设置为 NULL。
返回值
类型: HRESULT
如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。
注解
此方法不会创建新项,而只是声明要创建的项。 若要创建新项,必须至少进行此处详述的调用序列:
- 调用 IFileOperation::NewItem 以声明新文件或文件夹的具体信息。
- 调用 IFileOperation::P erformOperations 以创建新项。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | shobjidl_core.h (包括 Shobjidl.h) |