Skip to content

Latest commit

 

History

History
149 lines (116 loc) · 4.88 KB

File metadata and controls

149 lines (116 loc) · 4.88 KB
title IRunnableObjectImpl Class | Microsoft Docs
ms.custom
ms.date 11/04/2016
ms.reviewer
ms.suite
ms.technology
cpp-windows
ms.tgt_pltfrm
ms.topic reference
f1_keywords
IRunnableObjectImpl
ATLCTL/ATL::IRunnableObjectImpl
ATLCTL/ATL::IRunnableObjectImpl::GetRunningClass
ATLCTL/ATL::IRunnableObjectImpl::IsRunning
ATLCTL/ATL::IRunnableObjectImpl::LockRunning
ATLCTL/ATL::IRunnableObjectImpl::Run
ATLCTL/ATL::IRunnableObjectImpl::SetContainedObject
dev_langs
C++
helpviewer_keywords
containers, running controls
IRunnableObjectImpl class
IRunnableObject, ATL implementation
controls [ATL], running
controls [C++], container running in ATL
ms.assetid 305c7c3b-889e-49dd-aca1-34379c1b9931
caps.latest.revision 20
author mikeblome
ms.author mblome
manager ghogen
translation.priority.ht
cs-cz
de-de
es-es
fr-fr
it-it
ja-jp
ko-kr
pl-pl
pt-br
ru-ru
tr-tr
zh-cn
zh-tw

IRunnableObjectImpl Class

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