Edit

IRunnableObjectImpl Class

  • Article

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

Important

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

Syntax

template<class T>
class IRunnableObjectImpl

Parameters

T
Your class, derived from IRunnableObjectImpl.

Members

Public Methods

Name Description
IRunnableObjectImpl::GetRunningClass Returns the CLSID of the running control. The ATL implementation sets the CLSID to GUID_NULL and returns E_UNEXPECTED.
IRunnableObjectImpl::IsRunning Determines if the control is running. The ATL implementation returns TRUE.
IRunnableObjectImpl::LockRunning Locks the control into the running state. The ATL implementation returns S_OK.
IRunnableObjectImpl::Run Forces the control to run. The ATL implementation returns S_OK.
IRunnableObjectImpl::SetContainedObject Indicates that the control is embedded. The ATL implementation returns S_OK.

Remarks

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

Inheritance Hierarchy

IRunnableObject

IRunnableObjectImpl

Requirements

Header: atlctl.h

IRunnableObjectImpl::GetRunningClass

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.

IRunnableObjectImpl::IsRunning

Determines if the control is running.

virtual BOOL IsRunning();

Return Value

The ATL implementation returns TRUE.

Remarks

See IRunnableObject::IsRunning in the Windows SDK.

IRunnableObjectImpl::LockRunning

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.

IRunnableObjectImpl::Run

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.

IRunnableObjectImpl::SetContainedObject

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.

See also

CComControl Class
Class Overview