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 the object identified by the specified moniker is currently running. This method looks for the moniker in the Running Object Table (ROT).

Syntax

HRESULT IsRunning(
  IMoniker* 
pmkObjectName 
);

Parameters

pmkObjectName

[in] Pointer to the IMonikerinterface on the moniker to search for in the Running Object Table.

Return Value

S_OK

The object identified by pmkObjectNameis running.

S_FALSE

There is no entry for pmkObjectNamein the ROT, or that the object it identifies is no longer running (in which case, the entry is revoked).

Remarks

This method simply indicates whether a object is running. To retrieve a pointer to a running object, use the IRunningObjectTable::GetObjectmethod.

To determine whether the platform supports this interface, see Determining Supported COM APIs.

Notes to Callers

Generally, you call the IRunningObjectTable::IsRunningmethod only if you are writing your own moniker class (that is, implementing the IMonikerinterface).

You typically call this method from your implementation of IMoniker::IsRunning. However, you should do so only if the pmkToLeftparameter of IMoniker::IsRunningis NULL. Otherwise, you should call IMoniker::IsRunningon your pmkToLeftparameter instead.

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