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

Declara un único elemento al que se va a asignar un nuevo nombre para mostrar.

Sintaxis

HRESULT RenameItem(
  [in] IShellItem                 *psiItem,
  [in] LPCWSTR                    pszNewName,
  [in] IFileOperationProgressSink *pfopsItem
);

Parámetros

[in] psiItem

Tipo: IShellItem*

Puntero a un IShellItem que especifica el elemento de origen.

[in] pszNewName

Tipo: LPCWSTR

Puntero al nuevo nombre para mostrar del elemento. Se trata de una cadena Unicode terminada en null.

[in] pfopsItem

Tipo: IFileOperationProgressSink*

Puntero a un objeto IFileOperationProgressSink que se usará para las notificaciones de estado y error. Si llama a IFileOperation::Advise para la operación general, el estado de progreso y las notificaciones de error para la operación de cambio de nombre se incluyen allí, así que establezca este parámetro en NULL.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Este método no cambia el nombre del elemento, simplemente declara el elemento al que se va a cambiar el nombre. Para cambiar el nombre de un objeto, debe realizar al menos la secuencia de llamadas que se detallan aquí:

1. Llame a IFileOperation::RenameItem para declarar el nuevo nombre.
2. Llame a IFileOperation::P erformOperations para comenzar la operación de cambio de nombre.

Requisitos

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)

Consulte también

IFileOperation

IFileOperation::RenameItems

PostRenameItem

PreRenameItem