IRunnableObject::IsRunning-Methode (objidl.h)
Bestimmt, ob sich ein Objekt derzeit im Ausführungszustand befindet.
Syntax
BOOL IsRunning();
Rückgabewert
Wenn sich das Objekt im Ausführungszustand befindet, ist der Rückgabewert TRUE. Andernfalls ist es FALSE.
Hinweise
Eine Containeranwendung könnte IRunnableObject::IsRunning aufrufen, wenn sie wissen muss, ob der Server sofort verfügbar ist. Beispielsweise würde die Implementierung der IOleItemContainer::GetObject-Methode eines Containers einen Fehler zurückgeben, wenn der Server nicht ausgeführt wird und der bindspeed-Parameter BINDSPEED_IMMEDIATE angibt.
Ein Objekthandler könnte IRunnableObject::IsRunning aufrufen, wenn Konflikte mit einem ausgeführten Server vermieden werden sollen oder wenn der ausgeführte Server möglicherweise aktuellere Informationen enthält. Beispielsweise würde die Implementierung von IOleObject::GetExtent eines Handlers an den Objektserver delegieren, wenn er ausgeführt wird, da die Informationen des Servers möglicherweise aktueller sind als die Informationen im Cache des Handlers.
OleIsRunning ist eine Hilfsfunktion, die die von IRunnableObject::IsRunning angebotene Funktionalität bequem neu packt. Mit der Veröffentlichung von OLE 2.01 wurde die Implementierung von OleIsRunning so geändert, dass QueryInterface aufgerufen, nach IRunnableObject gefragt und dann IRunnableObject::IsRunning aufgerufen wird. Anders ausgedrückt: Sie können die Schnittstelle und die Hilfsfunktion austauschbar verwenden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | objidl.h |