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

  • Artigo

Declara um novo item que deve ser criado em um local especificado.

Sintaxe

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

Parâmetros

[in] psiDestinationFolder

Tipo: IShellItem*

Ponteiro para um IShellItem que especifica a pasta de destino que conterá o novo item.

[in] dwFileAttributes

Tipo: DWORD

Um valor bit a bit que especifica os atributos do sistema de arquivos para o arquivo ou pasta. Consulte GetFileAttributes para obter valores possíveis.

[in] pszName

Tipo: LPCWSTR

Ponteiro para o nome do arquivo do novo item, por exemplo ,Newfile.txt. Essa é uma cadeia de caracteres Unicode terminada em nulo.

[in] pszTemplateName

Tipo: LPCWSTR

Ponteiro para o nome do arquivo de modelo (por exemplo ,Excel9.xls) no qual o novo item se baseia, armazenado em um dos seguintes locais:

  • CSIDL_COMMON_TEMPLATES. O caminho padrão para essa pasta é %ALLUSERSPROFILE%\Templates.
  • CSIDL_TEMPLATES. O caminho padrão para essa pasta é %USERPROFILE%\Templates.
  • %SystemRoot%\shellnew
Essa é uma cadeia de caracteres Unicode terminada em nulo usada para especificar um arquivo existente do mesmo tipo que o novo arquivo, contendo o conteúdo mínimo que um aplicativo deseja incluir em qualquer novo arquivo.

Esse parâmetro normalmente é NULL para especificar um novo arquivo em branco.

[in] pfopsItem

Tipo: IFileOperationProgressSink*

Ponteiro para um objeto IFileOperationProgressSink a ser usado para status e notificações de falha. Se você chamar IFileOperation::Advise para a operação geral, as status de progresso e as notificações de erro para a operação de criação serão incluídas lá, portanto, defina esse parâmetro como NULL.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Esse método não cria o novo item, apenas declara o item a ser criado. Para criar um novo item, você deve fazer pelo menos a sequência de chamadas detalhada aqui:

  1. Chame IFileOperation::NewItem para declarar as especificidades do novo arquivo ou pasta.
  2. Chame IFileOperation::P erformOperations para criar o novo item.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shobjidl_core.h (inclua Shobjidl.h)

Confira também

Ifileoperation

PostNewItem

PreNewItem