Export (0) Print
Expand All

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.

MethodDescription
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

ObjIdl.h

IDL

ObjIdl.idl

IID

IID_IRunnableObject is defined as 00000126-0000-0000-C000-000000000046

 

 

Community Additions

ADD
Show:
© 2014 Microsoft