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.
A version of this page is also available for
4/8/2010

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

See Also

Reference

OleIsRunning