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 indicates whether the object identified by the specified name is running.

Syntax 

HRESULT IsRunning(
  LPOLESTR 
pszItem 
);

Parameters

pszItem

[in] Pointer to a zero-terminated wide character string (two bytes per character) containing the container's name for the object.

Return Value

The following table shows the return values for this method.

Value Description

S_OK

The specified object is running.

S_FALSE

The object is not running.

MK_E_NOOBJECT

The parameter pszItemdoes not identify an object in this container.

Remarks

The item moniker implementation of the IMoniker::IsRunningmethod calls this method.

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

Notes to Implementers

Your implementation of IOleItemContainer::IsRunningshould first determine whether pszItemidentifies one of the container's objects. If it does not, your implementation should return MK_E_NOOBJECT.

If the object is not loaded, your implementation should return S_FALSE.

If it is loaded, your implementation can call the OleIsRunningfunction to determine whether it is running.

If pszItemnames a pseudo-object, your implementation can simply return S_OK because a pseudo-object is running whenever its container is running.

Requirements

Header objidl.h, objidl.idl
Library ole32.lib
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also