IRunningObjectTable::IsRunning method (objidl.h)

Determines whether the object identified by the specified moniker is currently running.

Syntax

HRESULT IsRunning(
  [in] IMoniker *pmkObjectName
);

Parameters

[in] pmkObjectName

A pointer to the IMoniker interface on the moniker.

Return value

If the object is in the running state, the return value is TRUE. Otherwise, it is FALSE.

Remarks

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

Notes to Callers

Generally, you call the IsRunning method only if you are writing your own moniker class (that is, implementing the IMoniker interface). You typically call this method from your implementation of IMoniker::IsRunning. However, you should do so only if the pmkToLeft parameter of IMoniker::IsRunning is NULL. Otherwise, you should call IMoniker::IsRunning on your pmkToLeft parameter instead.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header objidl.h

See also

IMoniker::IsRunning

IRunningObjectTable