BUG: You receive an error LNK2001 when you try to use the >> operator to serialize one of the extension DLL classes in Visual C++

   mainfrm.obj : error LNK2001: unresolved external symbol
       "class CArchive & __stdcall operator>>
           (class CArchive &,class CClassInExtDLL * &)"
               (??5@YGAAVCArchive@@AAV0@AAPAVCDummyDoc@@@Z)
					

   friend CArchive& AFXAPI operator>>(CArchive& ar, CMyObject* &pOb);
				

   #define DECLARE_SERIAL_EXTDLL(class_name)   \ 
           _DECLARE_DYNCREATE(class_name)      \ 
           AFX_EXT_API friend CArchive& AFXAPI \ 
           operator>>(CArchive& ar, class_name* &pOb);
				

MORE INFORMATION

In order to make a class serializable by the use of a CArchive object, the class must be derived from CObject and must implement the DECLARE_SERIAL and IMPLEMENT_SERIAL macros. These macros are needed because they define an overloaded function, operator>>, explicitly for that class. In a case where that class is defined in an extension DLL and is exported by using the AFX_EXT_CLASS macro, the overloaded function, operator>>, does not get exported along with the class. Thus, if the main application instantiates an object of that class type and tries to serialize that object by the use of a CArchive object, a LNK2001 unresolved external error will occur.

Sample Code

Declare your class in the extension DLL this way:

In the header (.h) file for CMyObject:

   #define DECLARE_SERIAL_EXTDLL(class_name)   \ 
           _DECLARE_DYNCREATE(class_name)      \ 
           AFX_EXT_API friend CArchive& AFXAPI \ 
           operator>>(CArchive& ar, class_name* &pOb);

   class AFX_EXT_CLASS CMyObject : public CObject
   {
       DECLARE_SERIAL_EXTDLL(CMyObject)
       ...

   };

   In the implementation (.cpp) file for CMyObject:

   ...

   IMPLEMENT_SERIAL(CMyObject, CObject, YOUR_SCHEMA_NUMBER_HERE)

   ...