Méthode IRunnableObject ::IsRunning (objidl.h)

Détermine si un objet est actuellement à l’état en cours d’exécution.

Syntaxe

BOOL IsRunning();

Valeur de retour

Si l’objet est dans l’état en cours d’exécution, la valeur de retour est TRUE. Sinon, elle est FALSE.

Remarques

Une application conteneur peut appeler IRunnableObject ::IsRunning lorsqu’elle doit savoir si le serveur est immédiatement disponible. Par exemple, l’implémentation d’un conteneur de la méthode IOleItemContainer ::GetObject renvoie une erreur si le serveur n’est pas en cours d’exécution et si le paramètre bindspeed spécifie BINDSPEED_IMMEDIATE.

Un gestionnaire d’objets peut appeler IRunnableObject ::IsRunning lorsqu’il souhaite éviter les conflits avec un serveur en cours d’exécution ou lorsque le serveur en cours d’exécution peut avoir des informations plus à jour. Par exemple, l’implémentation d’un gestionnaire de IOleObject ::GetExtent déléguerait au serveur d’objets s’il est en cours d’exécution, car les informations du serveur peuvent être plus actuelles que celles du cache du gestionnaire.

OleIsRunning est une fonction d’assistance qui réemballe commodément les fonctionnalités offertes par IRunnableObject ::IsRunning. Avec la version d’OLE 2.01, l’implémentation d’OleIsRunning a été modifiée de sorte qu’elle appelle QueryInterface, demande IRunnableObject, puis appelle IRunnableObject ::IsRunning. En d’autres termes, vous pouvez utiliser l’interface et la fonction d’assistance de manière interchangeable.

Configuration requise

Voir aussi

IRunnableObject

OleIsRunning