Méthode IOleClientSite ::SaveObject (oleidl.h)

Enregistre l’objet incorporé associé au site client. Cette fonction est synchrone ; au moment de son retour, l’enregistrement est terminé.

Syntaxe

HRESULT SaveObject();

Valeur de retour

Cette méthode retourne S_OK en cas de réussite. Les autres valeurs de retour possibles sont les suivantes.

Remarques

Un objet incorporé appelle SaveObject pour demander à son conteneur de l’enregistrer dans un stockage persistant lorsqu’un utilisateur final choisit les commandes File Update ou Exit. L’appel est synchrone, ce qui signifie qu’au moment de son retour, l’opération d’enregistrement est terminée.

Les appels à SaveObject se produisent dans la plupart des implémentations de IOleObject ::Close. Normalement, lorsqu’un conteneur indique à un objet de se fermer, le conteneur transmet un indicateur spécifiant si l’objet doit s’enregistrer lui-même avant de se fermer, demander des instructions à l’utilisateur ou fermer sans s’enregistrer lui-même. Si un objet est invité à s’enregistrer lui-même, par son conteneur ou par un utilisateur final, il appelle SaveObject pour demander à l’application conteneur d’enregistrer le contenu de l’objet avant que l’objet ne se ferme. Si un conteneur demande à un objet de ne pas s’enregistrer lui-même, l’objet ne doit pas appeler SaveObject.

Configuration requise

Voir aussi

IOleClientSite

IOleObject ::Close