CArchive::ReadObject

Reads object data from the archive and constructs an object of the appropriate type.

CObject* ReadObject(
   const CRuntimeClass* pClass 
);

Parameters

  • pClass
    A constant pointer to the CRuntimeClass structure that corresponds to the object you expect to read.

Return Value

A CObject pointer that must be safely cast to the correct derived class by using CObject::IsKindOf.

Remarks

This function is normally called by the CArchive extraction (>>) operator overloaded for a CObject pointer. ReadObject, in turn, calls the Serialize function of the archived class.

If you supply a nonzero pClass parameter, which is obtained by the RUNTIME_CLASS macro, then the function verifies the run-time class of the archived object. This assumes you have used the IMPLEMENT_SERIAL macro in the implementation of the class.

Example

See the example for CArchive::WriteObject.

Requirements

Header: afx.h

See Also

Concepts

CArchive Class

CArchive Members

Hierarchy Chart

CArchive::WriteObject

CObject::IsKindOf