IStorage::D estroyElement-Methode (objidl.h)

  • Artikel

Die DestroyElement-Methode entfernt den angegebenen Speicher oder Stream aus diesem Speicherobjekt.

Syntax

HRESULT DestroyElement(
  [in] const OLECHAR *pwcsName
);

Parameter

[in] pwcsName

Ein Zeiger auf eine Unicode-Zeichenfolge mit Breitzeichen mit NULL-Termin, die den Namen des zu entfernenden Speichers oder Streams enthält.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode Beschreibung
S_OK Das Element wurde erfolgreich entfernt.
E_PENDING Nur asynchroner Speicher: Ein Teil oder alle Elementdaten sind derzeit nicht verfügbar.
STG_E_ACCESSDENIED Der Aufrufer verfügt nicht über Berechtigungen zum Entfernen des Elements.
STG_E_FILENOTFOUND Das Element mit dem angegebenen Namen ist nicht vorhanden.
STG_E_INSUFFICIENTMEMORY Das Element wurde aufgrund eines Mangels an Arbeitsspeicher nicht entfernt.
STG_E_INVALIDNAME Ungültiger Wert für pwcsName.
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 entfernt, da zu viele dateien geöffnet sind.

Hinweise

Die DestroyElement-Methode löscht einen Unterspeicher oder Stream aus dem aktuellen Speicherobjekt. Nach einem erfolgreichen Aufruf von DestroyElement wird jede geöffnete instance des zerstörten Elements aus dem übergeordneten Speicher ungültig.

Wenn ein Speicherobjekt im transaktionsfähigen Modus geöffnet wird, erfordert die Zerstörung eines Elements, dass auf den Aufruf von DestroyElement ein Aufruf von IStorage::Commit folgt.

Hinweis Die DestroyElement-Methode verkleinern den Verzeichnisdatenstrom nicht. Er markiert nur den gelöschten Verzeichniseintrag als ungültig. Ungültige Einträge werden beim Erstellen eines neuen Speichers oder Streams wiederverwendet.

Bei Inhaltsstreams werden die gelöschten Streamsektoren als frei gekennzeichnet. Wenn sich die freien Sektoren am Ende der Datei befinden, sollte die Dokumentdatei verkleinern. Um eine Dokumentdatei zu komprimieren, rufen Sie IStorage::CopyTo für das Stammspeicherobjekt auf, und kopieren Sie sie in ein neues Speicherobjekt.

 

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 von Zusammengesetzten Dateien