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
| 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 | objidl.h |