Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This method indicates whether the object identified by the specified name is running.
HRESULT IsRunning(LPOLESTRpszItem);
Parameters
- pszItem
[in] Pointer to a zero-terminated wide character string (two bytes per character) containing the container's name for the object.
Return Values
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
OS Versions: Windows CE 3.0 and later.
Header: Objidl.h, Objidl.idl.
Link Library: Ole32.lib
See Also
OleIsRunning | IMoniker::IsRunning
Send Feedback on this topic to the authors