CArchive::ReadObject

Syntax

Protected:
CObject* ReadObject( const CRuntimeClass*
pClass )
throw( CFileException, CArchiveException, CMemoryException );

Parameters

pClass

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

Remarks

Reads object data from the archive and constructs an object of the appropriate type. If the object contains pointers to other objects, those objects are constructed automatically.

This protected function is usually called by the public 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.

Return Value

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

See Also

CArchive::WriteObject, CObject::IsKindOf