Important: |
---|
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
This method determines whether an object is currently in the running state.
Syntax
BOOL IsRunning(); |
Parameters
None.
Return Value
- TRUE
-
The object is in the running state.
- FALSE
-
The object is not in the running state.
Remarks
A container application could call IRunnableObject::IsRunningwhen it needs to know if the server is immediately available.
For example, a container's implementation of the IOleItemContainer::GetObjectmethod would return an error if the server is not running and the bindspeedparameter specifies BINDSPEED_IMMEDIATE.
An object handler could call IRunnableObject::IsRunningwhen it wants to avoid conflicts with a running server or when the running server might have more up-to-date information.
For example, a handler's implementation of IOleObject::GetExtentwould delegate to the object server if it is running, because the server's information might be more current than that in the handler's cache.
OleIsRunningis a helper function that conveniently repackages the functionality offered by IRunnableObject::IsRunning.
With the release of OLE 2.01, the implementation of OleIsRunningwas changed so that it calls QueryInterface, asks for IRunnableObject, and then calls IRunnableObject::IsRunning. In other words, you can use the interface and the helper function interchangeably.
To determine whether the platform supports this interface, see Determining Supported COM APIs.
Requirements
Header | objidl.h, objidl.idl |
Library | ole32.lib, uuid.lib |
Windows Embedded CE | Windows CE 3.0 and later |
Windows Mobile | Windows Mobile Version 5.0 and later |