IOleItemContainer::IsRunning
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 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 |
| Windows Embedded CE | Windows CE 3.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |