IRunnableObject
The IRunnableObject
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 Methods |
Description |
|
QueryInterface |
Returns
pointers to supported interfaces. |
|
AddRef |
Increments
reference count. |
|
Release |
Decrements
reference count. |
|
IRunnableObject
Methods |
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. |