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

  • Artigo

Executa ações implementadas pelo chamador após a criação do novo item.

Sintaxe

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 contém sinalizadores que foram usados durante a operação de criação. Alguns valores podem ser definidos ou alterados durante a operação de criação. Consulte TRANSFER_SOURCE_FLAGS para obter descrições de sinalizador.

[in] psiDestinationFolder

Tipo: IShellItem*

Ponteiro para um IShellItem que especifica a pasta de destino à qual o novo item foi adicionado.

[in] pszNewName

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.

Normalmente, esse parâmetro é NULL para especificar um novo arquivo em branco.

[in] dwFileAttributes

Tipo: DWORD

Os atributos de arquivo aplicados ao novo item. Um ou mais dos valores encontrados em GetFileAttributes.

[in] hrNew

Tipo: HRESULT

O valor retornado da operação de criação. Observe que esse não é o HRESULT retornado por NewItem, que simplesmente enfileira a operação de criação. Em vez disso, esse é o resultado da criação real.

[in] psiNewItem

Tipo: IShellItem*

Ponteiro para um IShellItem que representa o novo item.

Retornar valor

Tipo: HRESULT

Retorna S_OK se tiver êxito; caso contrário, um valor de erro. No caso de um valor de erro, todas as operações subsequentes pendentes da chamada para IFileOperation são canceladas.

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)