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:
- Chiamare IFileOperation::RenameItem per dichiarare il nuovo nome.
- 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) |