IRunnableObjectImpl Class

 

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at IRunnableObjectImpl Class.

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: