Metodo IStorage::RenameElement (objidl.h)

Articolo
08/25/2023

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.

NotaPwcsName, creato in CreateStorage o CreateStream non deve superare 31 caratteri di lunghezza, non incluso il terminatore di stringa.

[in] pwcsNewName

Puntatore a una stringa unicode con terminazione null di caratteri wide contenente il nuovo nome per la sottostorage o il flusso specificati.

NotaPwcsName, creato in CreateStorage o CreateStream non deve superare 31 caratteri di lunghezza, non incluso il terminatore di stringa.

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

Vedi anche

IStorage - Implementazione di file composti

Condividi tramite