Condividi tramite


Metodo IFileOperation::RenameItem (shobjidl_core.h)

Dichiara un singolo elemento da assegnare a un nuovo nome visualizzato.

Sintassi

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

Parametri

[in] psiItem

Tipo: IShellItem*

Puntatore a un oggetto IShellItem che specifica l'elemento di origine.

[in] pszNewName

Tipo: LPCWSTR

Puntatore al nuovo nome visualizzato dell'elemento. Stringa Unicode con terminazione Null.

[in] pfopsItem

Tipo: IFileOperationProgressSink*

Puntatore a un oggetto IFileOperationProgressSink da usare per le notifiche di stato e di errore. Se si chiama IFileOperation::Advise per l'operazione complessiva, sono incluse le notifiche relative allo stato di avanzamento e agli errori per l'operazione di ridenominazione, quindi impostare questo parametro su NULL.

Valore restituito

Tipo: HRESULT

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

Commenti

Questo metodo non rinomina l'elemento, ma dichiara semplicemente l'elemento da rinominare. Per rinominare un oggetto, è necessario effettuare almeno la sequenza di chiamate descritte di seguito:

  1. Chiamare IFileOperation::RenameItem per dichiarare il nuovo nome.
  2. Chiamare IFileOperation::P erformOperations per avviare l'operazione di ridenominazione.

Requisiti

   
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shobjidl_core.h (include Shobjidl.h)

Vedi anche

IFileOperation

IFileOperation::RenameItems

PostRenameItem

PreRenameItem