Méthode IOleCacheControl ::OnRun (oleidl.h)
Avertit le cache que l’objet de source de données est entré dans l’état d’exécution afin que l’objet de cache puisse établir des récepteurs en fonction des besoins.
Syntaxe
HRESULT OnRun(
[in] LPDATAOBJECT pDataObject
);
Paramètres
[in] pDataObject
Pointeur vers l’interface IDataObject sur l’objet qui entre dans l’état d’exécution.
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 |
|---|---|
|
L’un des arguments n’est pas valide. |
|
Une erreur inattendue s’est produite. |
|
La mémoire disponible est insuffisante pour cette opération. |
Remarques
Quand OnRun est appelé, le cache configure les connexions de conseil en fonction des besoins avec l’objet de données source afin qu’il puisse recevoir des notifications. La connexion de conseil créée entre l’objet en cours d’exécution et le cache est détruite lorsque IOleCacheControl ::OnStop est appelé.
Certains gestionnaires d’objets ou serveurs in-process peuvent utiliser le cache de manière passive et ne pas appeler OnRun. Ces applications doivent appeler IOleCache2 ::UpdateCache, IOleCache ::InitCache ou IOleCache ::SetData pour remplir le cache si nécessaire afin de s’assurer que le cache est mis à jour.
OnRun n’ajoute pas de nombre de références sur le pointeur vers IDataObject passé dans pDataObject. Étant donné qu’il incombe à l’appelant d’OleRun de s’assurer que la durée de vie du pointeur pDataObject dure jusqu’à l’appel de OnStop , l’appelant doit conserver un pointeur vers IDataObject sur l’objet de données qui vous intéresse.
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 |