Metodo IStorage::RenameElement (objidl.h)
Il metodo RenameElement rinomina la sottostorage o il flusso specificati in questo oggetto di archiviazione.
Sintassi
HRESULT RenameElement(
[in] const OLECHAR *pwcsOldName,
[in] const OLECHAR *pwcsNewName
);
Parametri
[in] pwcsOldName
Puntatore a una stringa Unicode con terminazione null di caratteri wide contenente il nome della sottostorage o del flusso da modificare.
[in] pwcsNewName
Puntatore a una stringa unicode con terminazione null di caratteri wide contenente il nuovo nome per la sottostorage o il flusso specificati.
Valore restituito
Questo metodo può restituire uno di questi valori.
| Codice restituito | Descrizione |
|---|---|
| S_OK | L'elemento è stato rinominato correttamente. |
| E_PENDING | Solo archiviazione asincrona: parte o tutti i dati dell'elemento non sono attualmente disponibili. |
| STG_E_ACCESSDENIED | Il chiamante non dispone di autorizzazioni sufficienti per rinominare l'elemento. |
| STG_E_FILENOTFOUND | L'elemento con il nome precedente specificato non esiste. |
| STG_E_FILEALREADYEXISTS | L'elemento specificato dal nuovo nome esiste già. |
| STG_E_INSUFFICIENTMEMORY | L'elemento non è stato rinominato a causa di una mancanza di memoria. |
| STG_E_INVALIDNAME | Valore non valido per uno dei nomi. |
| STG_E_INVALIDPOINTER | Il puntatore specificato per l'elemento non è valido. |
| STG_E_INVALIDPARAMETER | Uno dei parametri non è valido. |
| STG_E_REVERTED | L'oggetto di archiviazione è stato invalidato da un'operazione di ripristino sopra di essa nell'albero delle transazioni. |
| STG_E_TOOMANYOPENFILES | L'elemento non è stato rinominato perché sono presenti troppi file aperti. |
Commenti
IStorage::RenameElement rinomina la sottostorage o il flusso specificati in questo oggetto di archiviazione. Impossibile rinominare un elemento in un oggetto di archiviazione mentre è aperto. L'operazione di ridenominazione è soggetta al commit delle modifiche se l'archiviazione è aperta in modalità transazionata.
Il metodo IStorage::RenameElement non è garantito che funzioni in memoria ridotta con oggetti di archiviazione aperti in modalità transazionata. Può funzionare in modalità diretta.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [app desktop | App UWP] |
| Server minimo supportato | Windows 2000 Server [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | objidl.h |
| Libreria | Uuid.lib |
| DLL | Ole32.dll |