Méthode IOleLink ::SetUpdateOptions (oleidl.h)

Article
03/01/2024

Spécifie la fréquence à laquelle un objet lié doit mettre à jour ses données mises en cache.

Syntaxe

HRESULT SetUpdateOptions(
  [in] DWORD dwUpdateOpt
);

Paramètres

[in] dwUpdateOpt

Spécifie la fréquence à laquelle un objet lié doit mettre à jour ses données mises en cache. Les valeurs possibles pour dwUpdateOpt proviennent de l’énumération OLEUPDATE.

Valeur retournée

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_INVALIDARG	La valeur fournie n’est pas valide.

Remarques

Remarques aux appelants

Votre application conteneur doit appeler IOleLink ::SetUpdateOptions lorsque l’utilisateur final modifie l’option de mise à jour d’un objet lié.

L’utilisateur final sélectionne l’option de mise à jour d’un objet lié à l’aide de la boîte de dialogue Liens . Si vous utilisez la fonction OleUIEditLinks pour afficher cette boîte de dialogue, vous devez implémenter l’interface IOleUILinkContainer . La boîte de dialogue appelle votre méthode IOleUILinkContainer ::SetLinkUpdateOptions pour spécifier l’option de mise à jour choisie par l’utilisateur final. Votre implémentation de cette méthode doit appeler la méthode IOleLink ::SetUpdateOptions pour passer l’option sélectionnée à l’objet lié.

Remarques aux implémenteurs

L’option de mise à jour par défaut est OLEUDPATE_ALWAYS. L’implémentation de IPersistStorage ::Save de l’objet lié enregistre l’option de mise à jour actuelle.

Si OLEUDPATE_ALWAYS est spécifié comme option de mise à jour, l’objet lié met à jour les caches du lien dans les situations suivantes :

Lorsque l’option de mise à jour passe de manuelle à automatique, si la source du lien est en cours d’exécution.
Chaque fois que l’objet lié est lié à la source du lien.
Chaque fois que la source du lien est en cours d’exécution et que les implémentations IOleObject ::Close, IPersistStorage ::Save ou IAdviseSink ::OnSave de l’objet lié sont appelées.

Pour les liens manuels et automatiques, l’objet lié met à jour le cache chaque fois que l’application conteneur appelle IOleObject ::Update ou IOleLink ::Update.

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