Compartir a través de

Método IFileOperationProgressSink::P ostNewItem (shobjidl_core.h)

  • Artículo

Realiza acciones implementadas por el autor de la llamada después de crear el nuevo elemento.

Sintaxis

HRESULT PostNewItem(
  [in] DWORD      dwFlags,
  [in] IShellItem *psiDestinationFolder,
  [in] LPCWSTR    pszNewName,
  [in] LPCWSTR    pszTemplateName,
  [in] DWORD      dwFileAttributes,
  [in] HRESULT    hrNew,
  [in] IShellItem *psiNewItem
);

Parámetros

[in] dwFlags

Tipo: DWORD

valor bit a bit que contiene marcas que se usaron durante la operación de creación. Algunos valores se pueden establecer o cambiar durante la operación de creación. Consulte TRANSFER_SOURCE_FLAGS para obtener descripciones de marcas.

[in] psiDestinationFolder

Tipo: IShellItem*

Puntero a un IShellItem que especifica la carpeta de destino a la que se agregó el nuevo elemento.

[in] pszNewName

Tipo: LPCWSTR

Puntero al nombre de archivo del nuevo elemento, por ejemplo ,Newfile.txt. Se trata de una cadena Unicode terminada en null.

[in] pszTemplateName

Tipo: LPCWSTR

Puntero al nombre del archivo de plantilla (por ejemplo ,Excel9.xls) en el que se basa el nuevo elemento, almacenado en una de las siguientes ubicaciones:

  • CSIDL_COMMON_TEMPLATES. La ruta de acceso predeterminada para esta carpeta es %ALLUSERSPROFILE%\Templates.
  • CSIDL_TEMPLATES. La ruta de acceso predeterminada para esta carpeta es %USERPROFILE%\Templates.
  • %SystemRoot%\shellnew
Se trata de una cadena Unicode terminada en null que se usa para especificar un archivo existente del mismo tipo que el nuevo archivo, que contiene el contenido mínimo que una aplicación quiere incluir en cualquier archivo nuevo.

Este parámetro suele ser NULL para especificar un nuevo archivo en blanco.

[in] dwFileAttributes

Tipo: DWORD

Atributos de archivo aplicados al nuevo elemento. Uno o varios de los valores encontrados en GetFileAttributes.

[in] hrNew

Tipo: HRESULT

Valor devuelto de la operación de creación. Tenga en cuenta que no es el HRESULT devuelto por NewItem, que simplemente pone en cola la operación de creación. En su lugar, este es el resultado de la creación real.

[in] psiNewItem

Tipo: IShellItem*

Puntero a un IShellItem que representa el nuevo elemento.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se realiza correctamente; de lo contrario, un valor de error. En el caso de un valor de error, se cancelan todas las operaciones posteriores pendientes de la llamada a IFileOperation .

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl_core.h (include Shobjidl.h)