IRunnableObject:IUnknown (Windows CE 5.0)
This interface enables a container to control the running of its embedded objects. In the case of an object implemented with a local server, calling IRunnableObject::Run launches the server's .exe file. In the case of an object implemented with an in-process server, calling the Run method causes the object .DLL file to transition into the running state.
When to Implement
Object handlers should implement IRunnableObject to provide their containers with a way to run them and manage their running state. DLL object applications should implement IRunnableObject to support silent updates of their objects.
When to Use
Containers call IRunnableObject to determine if an embedded object is running, to force an object to run, to lock an object into the running state, or to inform an object handler whether its object is being run as either a simple embedding or as a link source.
Methods VTable Order
| IUnknown method | Description |
|---|---|
| QueryInterface | Returns pointers to supported interfaces. |
| AddRef | Increments the reference count. |
| Release | Decrements the reference count. |
| Method | Description |
|---|---|
| GetRunningClass | Returns CLSID of a running object. |
| Run | Forces an object to run. |
| IsRunning | Determines if an object is running. |
| LockRunning | Locks an object into running state. |
| SetContainedObject | Indicates that an object is embedded. |
Remarks
To determine whether the platform supports this interface, see Determining Supported COM APIs.
Requirements
OS Versions: Windows CE 3.0 and later.
Header: Objidl.h, Objidl.idl.
Link Library: Ole32.lib, Uuid.lib.
Send Feedback on this topic to the authors