IStorage::RenameElement-Methode (objidl.h)

Artikel
08/25/2023

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

Freigeben über