Compartilhar via


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

Executa ações implementadas pelo chamador antes do processo de renomeação para cada item começar.

Sintaxe

HRESULT PreRenameItem(
  [in] DWORD      dwFlags,
  [in] IShellItem *psiItem,
  [in] LPCWSTR    pszNewName
);

Parâmetros

[in] dwFlags

Tipo: DWORD

valor bit a bit que contém sinalizadores que controlam a operação. Consulte TRANSFER_SOURCE_FLAGS para obter descrições de sinalizador.

[in] psiItem

Tipo: IShellItem*

Ponteiro para um IShellItem que especifica o item a ser renomeado.

[in] pszNewName

Tipo: LPCWSTR

Ponteiro para o novo nome de exibição do item. Essa é uma cadeia de caracteres Unicode terminada em nulo.

Retornar valor

Tipo: HRESULT

Retorna S_OK se tiver êxito; caso contrário, um valor de erro. No caso de um valor de erro, a operação de renomeação e 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)