Freigeben über


IStorage::RenameElement-Methode (objidl.h)

Die RenameElement-Methode benennt den angegebenen Unterspeicher oder Stream in diesem Speicherobjekt um.

Syntax

HRESULT RenameElement(
  [in] const OLECHAR *pwcsOldName,
  [in] const OLECHAR *pwcsNewName
);

Parameter

[in] pwcsOldName

Zeiger auf eine Unicode-Zeichenfolge mit breitem Zeichen null, die den Namen des zu ändernden Unterspeichers oder Streams enthält.

Hinweis Der pwcsName, der in CreateStorage oder CreateStream erstellt wurde, darf nicht länger als 31 Zeichen sein, wobei der Zeichenfolgenabschluss nicht enthalten ist.
 

[in] pwcsNewName

Zeiger auf eine unicode-Zeichenfolge mit breitem Zeichen mit NULL-Endung, die den neuen Namen für den angegebenen Unterspeicher oder Stream enthält.

Hinweis Der pwcsName, der in CreateStorage oder CreateStream erstellt wurde, darf nicht länger als 31 Zeichen sein, wobei der Zeichenfolgenabschluss nicht enthalten ist.
 

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode Beschreibung
S_OK Das Element wurde erfolgreich umbenannt.
E_PENDING Nur asynchroner Speicher: Ein Teil oder alle Daten des Elements sind derzeit nicht verfügbar.
STG_E_ACCESSDENIED Der Aufrufer verfügt nicht über ausreichende Berechtigungen zum Umbenennen des Elements.
STG_E_FILENOTFOUND Das Element mit dem angegebenen alten Namen ist nicht vorhanden.
STG_E_FILEALREADYEXISTS Das durch den neuen Namen angegebene Element ist bereits vorhanden.
STG_E_INSUFFICIENTMEMORY Das Element wurde aufgrund von Speichermangel nicht umbenannt.
STG_E_INVALIDNAME Ungültiger Wert für einen der Namen.
STG_E_INVALIDPOINTER Der für das Element angegebene Zeiger war ungültig.
STG_E_INVALIDPARAMETER Einer der Parameter war ungültig.
STG_E_REVERTED Das Speicherobjekt wurde durch einen rückgängig machen Vorgang darüber in der Transaktionsstruktur ungültig gemacht.
STG_E_TOOMANYOPENFILES Das Element wurde nicht umbenannt, da zu viele geöffnete Dateien vorhanden sind.

Hinweise

IStorage::RenameElement benennt den angegebenen Unterspeicher oder Stream in diesem Speicherobjekt um. Ein Element in einem Speicherobjekt kann nicht umbenannt werden, wenn es geöffnet ist. Der Umbenennungsvorgang unterliegt dem Commit der Änderungen, wenn der Speicher im Transaktionsmodus geöffnet ist.

Die IStorage::RenameElement-Methode funktioniert nicht in wenig Arbeitsspeicher, wobei Speicherobjekte im Transaktionsmodus geöffnet sind. Es kann im direkten Modus funktionieren.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile objidl.h
Bibliothek Uuid.lib
DLL Ole32.dll

Weitere Informationen

IStorage – Implementierung zusammengesetzter Dateien