CRuntimeClass Structure

Article
04/28/2015

Each class derived from CObject is associated with a CRuntimeClass structure that you can use to obtain information about an object or its base class at run time.

struct CRuntimeClass

Members

Public Methods

Name	Description
CRuntimeClass::CreateObject	Creates an object during run time.
CRuntimeClass::FromName	Creates an object during run time using the familiar class name.
CRuntimeClass::IsDerivedFrom	Determines if the class is derived from the specified class.

Public Data Members

Name	Description
CRuntimeClass::m_lpszClassName	The name of the class.
CRuntimeClass::m_nObjectSize	The size of the object in bytes.
CRuntimeClass::m_pBaseClass	A pointer to the CRuntimeClass structure of the base class.
CRuntimeClass::m_pfnCreateObject	A pointer to the function that dynamically creates the object.
CRuntimeClass::m_pfnGetBaseClass	Returns the CRuntimeClass structure (only available when dynamically linked).
CRuntimeClass::m_wSchema	The schema number of the class.

Remarks

CRuntimeClass is a structure and therefore does not have a base class.

The ability to determine the class of an object at run time is useful when extra type checking of function arguments is needed, or when you must write special-purpose code based on the class of an object. Run-time class information is not supported directly by the C++ language.

CRuntimeClass provides information on the related C++ object, such as a pointer to the CRuntimeClass of the base class and the ASCII class name of the related class. This structure also implements various functions that can be used to dynamically create objects, specifying the type of object by using a familiar name, and determining if the related class is derived from a specific class.

For more information on using CRuntimeClass, see the article Accessing Run-Time Class Information.

Inheritance Hierarchy

CRuntimeClass

Requirements

Header: afx.h