IOleClientSite::SaveObject-Methode (oleidl.h)

Speichert das eingebettete Objekt, das dem Clientstandort zugeordnet ist. Diese Funktion ist synchron; nach der Rückgabe wird der Speichervorgang abgeschlossen.

Syntax

HRESULT SaveObject();

Rückgabewert

Diese Methode gibt S_OK bei Erfolg zurück. Weitere mögliche Rückgabewerte:

Rückgabecode Beschreibung
E_FAIL
Beim Vorgang ist ein Fehler aufgetreten.

Hinweise

Ein eingebettetes Objekt ruft SaveObject auf, um seinen Container aufzufordern, es im persistenten Speicher zu speichern, wenn ein Endbenutzer die Befehle Dateiaktualisierung oder Beenden auswäht. Der Aufruf ist synchron, d. h., wenn er zurückgegeben wird, wird der Speichervorgang abgeschlossen.

Aufrufe von SaveObject erfolgen in den meisten Implementierungen von IOleObject::Close. Wenn ein Container ein Objekt anfordert, zu schließen, übergibt der Container normalerweise ein Flag, das angibt, ob sich das Objekt vor dem Schließen selbst speichern, den Benutzer zur Eingabe von Anweisungen auffordern oder schließen soll, ohne sich selbst zu speichern. Wenn ein Objekt angewiesen wird, sich selbst zu speichern, entweder durch seinen Container oder einen Endbenutzer, ruft es SaveObject auf, um die Containeranwendung aufzufordern, den Inhalt des Objekts zu speichern, bevor das Objekt sich selbst schließt. Wenn ein Container ein Objekt anweist, sich nicht selbst zu speichern, sollte das Objekt SaveObject nicht aufrufen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile oleidl.h

Weitere Informationen

IOleClientSite

IOleObject::Close