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 the Run method launches the server's .EXE file. In the case of an object implemented with an in-process server, calling Run 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.
Members
The IRunnableObject interface inherits from the IUnknown interface. IRunnableObject also has these types of members:
Methods
The IRunnableObject interface has these methods.
| Method | Description |
|---|---|
| GetRunningClass |
Retrieves the CLSID of a running object. |
| IsRunning |
Determines whether an object is currently in the running state. |
| LockRunning |
Locks an already running object into its running state or unlocks it from its running state. |
| Run |
Forces an object to run. |
| SetContainedObject |
Notifies an object that it is embedded in an OLE container. |
Requirements
|
Minimum supported client |
Windows 2000 Professional [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows 2000 Server [desktop apps only] |
|
Header |
|
|
IDL |
|
|
IID |
IID_IRunnableObject is defined as 00000126-0000-0000-C000-000000000046 |