Partager via


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.

Code de retour Description
E_FAIL
L’opération a échoué.

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

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête oleidl.h

Voir aussi

IOleClientSite

IOleObject ::Close