Поделиться через

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

[in] pszNewName

Тип: LPCWSTR

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

[in] pszTemplateName

Тип: LPCWSTR

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

  • CSIDL_COMMON_TEMPLATES. По умолчанию для этой папки используется путь %ALLUSERSPROFILE%\Templates.
  • CSIDL_TEMPLATES. По умолчанию для этой папки используется путь %USERPROFILE%\Templates.
  • %SystemRoot%\shellnew
Это строка Юникода со значением NULL, используемая для указания существующего файла того же типа, что и новый файл, содержащего минимальное содержимое, которое приложение хочет включить в любой новый файл.

Обычно этот параметр имеет значение NULL , чтобы указать новый пустой файл.

[in] dwFileAttributes

Тип: DWORD

Атрибуты файла, примененные к новому элементу. Одно или несколько значений, найденных в getFileAttributes.

[in] hrNew

Тип: HRESULT

Возвращаемое значение операции создания. Обратите внимание, что это не HRESULT, возвращенный NewItem, который просто помещает в очередь операцию создания. Вместо этого это результат фактического создания.

[in] psiNewItem

Тип: IShellItem*

Указатель на элемент IShellItem , представляющий новый элемент.

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

Тип: HRESULT

Возвращает S_OK в случае успешного выполнения или значение ошибки в противном случае. В случае значения ошибки все последующие операции, ожидающие вызова IFileOperation , отменяются.

Требования

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