This documentation is archived and is not being maintained.

CRuntimeClass::FromName

Call this function to retrieve the CRuntimeClass structure associated with the familiar name.

static CRuntimeClass* PASCAL FromName( 
   LPCSTR lpszClassName  
); 
static CRuntimeClass* PASCAL FromName( 
   LPCWSTR lpszClassName  
);

lpszClassName

The familiar name of a class derived from CObject.

A pointer to a CRuntimeClass object, corresponding to the name as passed in lpszClassName. The function returns NULL if no matching class name was found.

// This example creates an object if CAge is defined.

CRuntimeClass* pClass = CRuntimeClass::FromName(_T("CAge"));
if (pClass == NULL)
{
   // not found, display a warning for diagnostic purposes
   AfxMessageBox(_T("Warning: CMyClass not defined"));
   return NULL;
}

// attempt to create the object with the found CRuntimeClass
CObject* pObject = pClass->CreateObject();

Header: afx.h

Show: