IOleItemContainer::IsRunning (Windows Embedded CE 6.0)

1/6/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.

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

See Also

Reference

IOleItemContainer
OleIsRunning
IMoniker::IsRunning