Compartir a través de

Método IFileOperation::NewItem (shobjidl_core.h)

  • Artículo

Declara un nuevo elemento que se va a crear en una ubicación especificada.

Sintaxis

HRESULT NewItem(
  [in] IShellItem                 *psiDestinationFolder,
  [in] DWORD                      dwFileAttributes,
  [in] LPCWSTR                    pszName,
  [in] LPCWSTR                    pszTemplateName,
  [in] IFileOperationProgressSink *pfopsItem
);

Parámetros

[in] psiDestinationFolder

Tipo: IShellItem*

Puntero a un IShellItem que especifica la carpeta de destino que contendrá el nuevo elemento.

[in] dwFileAttributes

Tipo: DWORD

Valor bit a bit que especifica los atributos del sistema de archivos para el archivo o carpeta. Consulte GetFileAttributes para conocer los valores posibles.

[in] pszName

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] pfopsItem

Tipo: IFileOperationProgressSink*

Puntero a un objeto IFileOperationProgressSink que se usará para las notificaciones de estado y error. Si llama a IFileOperation::Advise para la operación general, el estado del progreso y las notificaciones de error para la operación de creación se incluyen allí, así que establezca este parámetro en NULL.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Este método no crea el nuevo elemento, simplemente declara el elemento que se va a crear. Para crear un nuevo elemento, debe realizar al menos la secuencia de llamadas que se detallan aquí:

  1. Llame a IFileOperation::NewItem para declarar los detalles del nuevo archivo o carpeta.
  2. Llame a IFileOperation::P erformOperations para crear el nuevo elemento.

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)

Consulte también

IFileOperation

PostNewItem

PreNewItem