IStorage::D estroyElement-Methode (objidl.h)
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.
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 |