IOleItemContainer::IsRunning method

Determines whether the specified object is running.

Syntax


HRESULT IsRunning(
  [in] LPOLESTR pszItem
);

Parameters

pszItem [in]

The container's name for the object.

Return value

This method can return the following values.

Return codeDescription
S_OK

The object is running.

S_FALSE

The object is not running.

MK_E_NOOBJECT

The parameter does not identify an object in this container.

 

Remarks

The item moniker implementation of IMoniker::IsRunning calls this method.

Notes to Implementers

Your implementation of IOleItemContainer::IsRunning should first determine whether pszItem identifies 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 OleIsRunning function to determine whether it is running.

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

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

OleIdl.h

IDL

OleIdl.idl

IID

IID_IOleItemContainer is defined as 0000011c-0000-0000-C000-000000000046

See also

IOleItemContainer

 

 

Show: