Share via


IOleItemContainer::IsRunning (Compact 2013)

3/26/2014

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 pszItem does not identify an object in this container.

Remarks

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

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

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

Header

objidl.h,
objidl.idl

Library

ole32.lib

See Also

Reference

IOleItemContainer
OleIsRunning
IMoniker::IsRunning