Condividi tramite

Metodo ITransferSource::RenameItem (shobjidl_core.h)

  • Articolo

Modifica il nome di un elemento, restituendo IShellItem con il nuovo nome.

Sintassi

HRESULT RenameItem(
  [in]  IShellItem            *psiSource,
  [in]  LPCWSTR               pszNewName,
  [in]  TRANSFER_SOURCE_FLAGS flags,
  [out] IShellItem            **ppsiNewDest
);

Parametri

[in] psiSource

Tipo: IShellItem*

Puntatore all'oggetto IShellItem da rinominare.

[in] pszNewName

Tipo: LPCWSTR

Puntatore a una stringa Unicode con terminazione Null contenente il nuovo nome.

[in] flags

Tipo: TRANSFER_SOURCE_FLAGS

Flag che controllano l'operazione file. Una o più costanti TRANSFER_SOURCE_FLAGS .

[out] ppsiNewDest

Tipo: IShellItem**

Quando termina, questo metodo contiene l'indirizzo di un puntatore all'oggetto IShellItem .

Valore restituito

Tipo: HRESULT

Restituisce uno dei valori seguenti o un codice di errore.

Codice restituito Descrizione
COPYENGINE_S_YES
 L'utente ha risposto "Sì" alla finestra di dialogo.
COPYENGINE_S_USER_RETRY
 L'utente ha risposto per ritentare l'azione corrente.
COPYENGINE_S_USER_IGNORED
 L'utente ha risposto "No" alla finestra di dialogo.
COPYENGINE_S_MERGE
 L'utente ha risposto alle cartelle di unione.
COPYENGINE_S_USER_RETRY_WITH_NEW_NAME
 L'utente ha risposto di ritentare il file con un nuovo nome.
COPYENGINE_S_DONT_PROCESS_CHILDREN
 Gli elementi figlio non devono essere elaborati.
COPYENGINE_S_PENDING
 L'errore è stato accodato e verrà visualizzato in un secondo momento.
COPYENGINE_E_USER_CANCELLED
 L'utente ha annullato l'azione corrente.
COPYENGINE_E_REQUIRES_ELEVATION
 L'operazione richiede privilegi elevati.

Requisiti

Requisito Valore
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)