Metodo IFileOperation::RenameItems (shobjidl_core.h)

Dichiara un set di elementi che devono essere assegnati a un nuovo nome visualizzato. Tutti gli elementi vengono assegnati allo stesso nome.

Sintassi

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

Parametri

[in] pUnkItems

Tipo: IUnknown*

Puntatore all'oggetto IUnknown dell'oggetto IShellItemArray, IDataObject o IEnumShellItems che rappresenta il gruppo di elementi da rinominare. È anche possibile puntare a un oggetto IPersistIDList per rappresentare un singolo elemento, che esegue in modo efficace la stessa funzione di IFileOperation::RenameItem.

[in] pszNewName

Tipo: LPCWSTR

Puntatore al nuovo nome visualizzato degli elementi. Si tratta di una stringa Unicode con terminazione Null.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Se più di uno degli elementi dell'insieme in pUnkItems si trova nella stessa cartella, i file rinominati vengono aggiunti con un numero di parentesi per differenziarli, ad esempio newfile(1).txt, newfile(2).txt e newfile(3).txt.

Questo metodo non rinomina gli elementi, dichiara semplicemente gli elementi da rinominare. Per rinominare un gruppo di oggetti, è necessario effettuare almeno la sequenza di chiamate dettagliate qui:

1. Chiamare IFileOperation::RenameItems per dichiarare i file o le cartelle di origine e il nuovo nome.
2. Chiamare IFileOperation::P erformOperations per avviare l'operazione di ridenominazione.

Requisiti

Vedi anche

IFileOperation

IFileOperation::RenameItem