Метод 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 , указывающий конечную папку, которая будет содержать новый элемент.

[in] dwFileAttributes

Тип: DWORD

Побитовое значение, указывающее атрибуты файловой системы для файла или папки. Возможные значения см. в разделе GetFileAttributes .

[in] pszName

Тип: LPCWSTR

Указатель на имя файла нового элемента, например Newfile.txt. Это строка Юникода, завершающаяся null.

[in] pszTemplateName

Тип: LPCWSTR

Указатель на имя файла шаблона (например ,Excel9.xls), на основе нового элемента, который хранится в одном из следующих расположений:

• CSIDL_COMMON_TEMPLATES. По умолчанию для этой папки используется путь %ALLUSERSPROFILE%\Templates.
• CSIDL_TEMPLATES. По умолчанию для этой папки используется путь %USERPROFILE%\Templates.
• %SystemRoot%\shellnew

Это строка Юникода, заканчивающаяся null, которая используется для указания существующего файла того же типа, что и новый файл, содержащего минимальное содержимое, которое приложение хочет включить в любой новый файл.

Этот параметр обычно имеет значение NULL для указания нового пустого файла.

[in] pfopsItem

Тип: IFileOperationProgressSink*

Указатель на объект IFileOperationProgressSink , который будет использоваться для уведомлений о состоянии и сбоях. Если вы вызываете IFileOperation::Совет для общей операции, в нее включаются уведомления о состоянии выполнения и ошибках для операции создания, поэтому задайте для этого параметра значение NULL.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Этот метод не создает новый элемент, он просто объявляет элемент для создания. Чтобы создать новый элемент, необходимо выполнить по крайней мере последовательность вызовов, описанную здесь:

1. Вызовите метод IFileOperation::NewItem , чтобы объявить особенности нового файла или папки.
2. Вызовите метод IFileOperation::P erformOperations , чтобы создать новый элемент.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	shobjidl_core.h (включая Shobjidl.h)

См. также раздел

IFileOperation

PostNewItem

PreNewItem