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

  • Artículo

Cambia el nombre de un elemento y devuelve el objeto IShellItem con el nuevo nombre.

Sintaxis

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

Parámetros

[in] psiSource

Tipo: IShellItem*

Puntero al objeto IShellItem al que se va a cambiar el nombre.

[in] pszNewName

Tipo: LPCWSTR

Puntero a una cadena Unicode terminada en null que contiene el nuevo nombre.

[in] flags

Tipo: TRANSFER_SOURCE_FLAGS

Marcas que controlan la operación de archivo. Una o varias de las constantes de TRANSFER_SOURCE_FLAGS .

[out] ppsiNewDest

Tipo: IShellItem**

Cuando este método finaliza, contiene la dirección de un puntero al objeto IShellItem .

Valor devuelto

Tipo: HRESULT

Devuelve uno de los siguientes o un código de error.

Código devuelto Descripción
COPYENGINE_S_YES
 El usuario respondió "Sí" al cuadro de diálogo.
COPYENGINE_S_USER_RETRY
 El usuario respondió para reintentar la acción actual.
COPYENGINE_S_USER_IGNORED
 El usuario respondió "No" al cuadro de diálogo.
COPYENGINE_S_MERGE
 El usuario respondió a las carpetas de combinación.
COPYENGINE_S_USER_RETRY_WITH_NEW_NAME
 El usuario respondió para reintentar el archivo con el nuevo nombre.
COPYENGINE_S_DONT_PROCESS_CHILDREN
 No se deben procesar los elementos secundarios.
COPYENGINE_S_PENDING
 El error se ha puesto en cola y se mostrará más adelante.
COPYENGINE_E_USER_CANCELLED
 El usuario canceló la acción actual.
COPYENGINE_E_REQUIRES_ELEVATION
 La operación requiere privilegios elevados.

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)