Método ITransferSource::RenameItem (shobjidl_core.h)

Altera o nome de um item, retornando o IShellItem com o novo nome.

Sintaxe

HRESULT RenameItem(
  [in]  IShellItem            *psiSource,
  [in]  LPCWSTR               pszNewName,
  [in]  TRANSFER_SOURCE_FLAGS flags,
  [out] IShellItem            **ppsiNewDest
);

Parâmetros

[in] psiSource

Tipo: IShellItem*

Um ponteiro para o objeto IShellItem a ser renomeado.

[in] pszNewName

Tipo: LPCWSTR

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o novo nome.

[in] flags

Tipo: TRANSFER_SOURCE_FLAGS

Sinalizadores que controlam a operação de arquivo. Uma ou mais das constantes TRANSFER_SOURCE_FLAGS .

[out] ppsiNewDest

Tipo: IShellItem**

Quando esse método retorna, contém o endereço de um ponteiro para o objeto IShellItem .

Retornar valor

Tipo: HRESULT

Retorna um dos seguintes ou um código de erro.

Código de retorno	Descrição
COPYENGINE_S_YES	O usuário respondeu "Sim" à caixa de diálogo.
COPYENGINE_S_USER_RETRY	O usuário respondeu para repetir a ação atual.
COPYENGINE_S_USER_IGNORED	O usuário respondeu "Não" à caixa de diálogo.
COPYENGINE_S_MERGE	O usuário respondeu às pastas de mesclagem.
COPYENGINE_S_USER_RETRY_WITH_NEW_NAME	O usuário respondeu para repetir o arquivo com o novo nome.
COPYENGINE_S_DONT_PROCESS_CHILDREN	Itens filho não devem ser processados.
COPYENGINE_S_PENDING	O erro foi enfileirado e será exibido posteriormente.
COPYENGINE_E_USER_CANCELLED	O usuário cancelou a ação atual.
COPYENGINE_E_REQUIRES_ELEVATION	A operação requer privilégios elevados.

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)