CArchive::ReadClass

CRuntimeClass* ReadClass( const CRuntimeClass* pClassRefRequested = NULL, UINT* pSchema = NULL, DWORD* obTag = NULL );
Throw CArchiveException;
Throw CNotSupportedException;

Return Value

A pointer to the CRuntimeClass structure.

Parameters

pClassRefRequested

A pointer to the CRuntimeClass structure that corresponds to the class reference requested. Can be NULL.

pSchema

A pointer to a schema of the run-time class previously stored.

obTag

A number that refers to an object’s unique tag. Used internally by the implementation of ReadObject. Exposed for advanced programming only; obTag normally should be NULL.

Remarks

Call this member function to read a reference to a class previously stored with WriteClass.

If pClassRefRequested is not NULL, ReadClass verifies that the archived class information is compatible with your runtime class. If it is not compatible, ReadClass will throw a CArchiveException.

Your runtime class must use DECLARE_SERIAL and IMPLEMENT_SERIAL; otherwise, ReadClass will throw a CNotSupportedException.

If pSchema is NULL, the schema of the stored class can be retrieved by calling CArchive::GetObjectSchema; otherwise, *pSchema will contain the schema of the run-time class that was previously stored.

You can use SerializeClass instead of ReadClass, which handles both reading and writing of the class reference.

Example

See the example for CArchive::WriteClass.

CArchive Overview | Class Members | Hierarchy Chart