Compartir a través de

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

  • Artículo

Declara un conjunto de elementos a los que se va a asignar un nuevo nombre para mostrar. Todos los elementos tienen el mismo nombre.

Sintaxis

HRESULT RenameItems(
  [in] IUnknown *pUnkItems,
  [in] LPCWSTR  pszNewName
);

Parámetros

[in] pUnkItems

Tipo: IUnknown*

Puntero al objeto IUnknown del objeto IShellItemArray, IDataObject o IEnumShellItems que representa el grupo de elementos cuyo nombre se va a cambiar. También puede apuntar a un objeto IPersistIDList para representar un solo elemento, logrando eficazmente la misma función que IFileOperation::RenameItem.

[in] pszNewName

Tipo: LPCWSTR

Puntero al nuevo nombre para mostrar de los elementos. Se trata de una cadena Unicode terminada 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

Si hay más de uno de los elementos de la colección en pUnkItems en la misma carpeta, los archivos con nombre cambiado se anexan con un número entre paréntesis para diferenciarlos, por ejemplo newfile(1).txt, newfile(2).txt y newfile(3).txt.

Este método no cambia el nombre de los elementos, simplemente declara los elementos cuyo nombre se va a cambiar. Para cambiar el nombre de un grupo de objetos, debe realizar al menos la secuencia de llamadas que se detallan aquí:

  1. Llame a IFileOperation::RenameItems para declarar los archivos o carpetas de origen y el nuevo nombre.
  2. Llame a IFileOperation::P erformOperations para comenzar la operación de cambio de nombre.

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 (incluya Shobjidl.h)

Consulte también

IFileOperation

IFileOperation::RenameItem