IRunnableObjectImpl Class

 

For the latest documentation on Visual Studio 2017 RC, see Visual Studio 2017 RC Documentation.

This class implements IUnknown and provides a default implementation of the IRunnableObject interface.

System_CAPS_ICON_important.jpg Important

This class and its members cannot be used in applications that execute in the Windows Runtime.

template<class T>  
class IRunnableObjectImpl

Parameters

T
Your class, derived from IRunnableObjectImpl.

Public Methods

NameDescription
IRunnableObjectImpl::GetRunningClassReturns the CLSID of the running control. The ATL implementation sets the CLSID to GUID_NULL and returns E_UNEXPECTED.
IRunnableObjectImpl::IsRunningDetermines if the control is running. The ATL implementation returns TRUE.
IRunnableObjectImpl::LockRunningLocks the control into the running state. The ATL implementation returns S_OK.
IRunnableObjectImpl::RunForces the control to run. The ATL implementation returns S_OK.
IRunnableObjectImpl::SetContainedObjectIndicates that the control is embedded. The ATL implementation returns S_OK.

The IRunnableObject interface enables a container to determine if a control is running, force it to run, or lock it into the running state. Class IRunnableObjectImpl provides a default implementation of this interface and implements IUnknown by sending information to the dump device in debug builds.

Related Articles ATL Tutorial, Creating an ATL Project

IRunnableObject

IRunnableObjectImpl

Header: atlctl.h

Returns the CLSID of the running control.

HRESULT GetRunningClass(LPCLSID lpClsid);

Return Value

The ATL implementation sets * lpClsid to GUID_NULL and returns E_UNEXPECTED.

Remarks

See IRunnableObject::GetRunningClass in the Windows SDK.

Determines if the control is running.

virtual BOOL IsRunning();

Return Value

The ATL implementation returns TRUE.

Remarks

See IRunnableObject::IsRunning in the Windows SDK.

Locks the control into the running state.

HRESULT LockRunning(BOOL fLock, BOOL fLastUnlockCloses);

Return Value

The ATL implementation returns S_OK.

Remarks

See IRunnableObject::LockRunning in the Windows SDK.

Forces the control to run.

HRESULT Run(LPBINDCTX lpbc);

Return Value

The ATL implementation returns S_OK.

Remarks

See IRunnableObject::Run in the Windows SDK.

Indicates that the control is embedded.

HRESULT SetContainedObject(BOOL fContained);

Return Value

The ATL implementation returns S_OK.

Remarks

See IRunnableObject::SetContainedObject in the Windows SDK.

CComControl Class
Class Overview

Show: