PRB: C2065 Error Occurs on GetWrapperWindow or Other Symbols

  #include <macname1.h>
  #include <macos/windows.h>
  #include <macname2.h>

  #include <afxwin.h>
				

MORE INFORMATION

When targeting applications for the Macintosh platform, the Winwlm.h header file is pulled in the default WLM libraries and declares many symbols needed to use Macintosh specific objects from a Windows application. For example, GetWrapperWindow returns the Macintosh window data structure WindowRef underlying the given the Windows HWND.

This header file may be included in applications manually or automatically pulled in when building MFC applications through the Afxwin.h header file. For example:

  afxwin.h
    afx.h
      afxver_.h
        afxv_w32.h
          windows.h // for Macintosh targets this is mac/include/windows.h
            winwlm.h // where GetWrapperWindow, and so on, are prototyped
              macname2.h // 
				

However, the Winwlm.h file excludes many symbols if certain native Macintosh header files are not previously included. For example, GetWrapperWindow is defined if MACOS\Windows.h is included beforehand. This behavior occurs because GetWrapperWindow, along with other symbols, is in a section dependent upon __WINDOWS__ being defined. MACOS\Windows.h defines __WINDOWS__ .

Below is a list of some of the more commonly-used symbols and the required header file. The header file must be included before Winwlm.h or Afxwin.h and surrounded by the inclusion Macname1.h and Macname2.h. For example:

Symbol                       Include
------                       ----------------
CFragConnectionID            macos/codefrag.h //__CODEFRAGMENTS__
CFragInitBlockPtr
WlmInit
WlmTerm
WrapInstance
UnwrapInstance
GetMacInstanceInformation
MenuRef                      macos/menus.h //__MENUS__
WlmInitEx
CheckoutMenu
WrapMenu
UnwrapMenu
UpdateMenuBar
WindowRef                    macos/windows.h //__WINDOWS__
ActivateForeignWindow
GetWindowWrapper
GetWrapperWindow
GetWrapperContainerWindow
WrapWindow
WrapWindowMinimal
UnwrapWindow
DialogRef                    macos/dialogs.h //__DIALOGS__
AfxGetNextEvent              macos/events.h //__EVENTS__
AfxWaitNextEvent
AfxEventAvail
AfxGetOSEvent
AfxOSEventAvail
GrafPortToClient             macos/types.h //__TYPES__
				

If these header files are not included, the following error messages are generated: If the following errors occur after including these headers it is because the Afxcmn.h header file was included later. The Afxcmn.h header file contains GetItem and SetItem member functions of several MFC classes that conflict with the ones defined in MACOS\Menus.h. For example:

   // macos/Menus.h
   #if OLDROUTINENAMES
   ...
   #define SetItem(theMenu, item, itemString) SetMenuItemText(theMenu,
   item, itemString)
   #define GetItem(theMenu, item, itemString) GetMenuItemText(theMenu,
   item, itemString)
   ...
   #endif // OLDROUTINENAMES
				

The workaround is to define OLDROUTINENAMES as 0. Below is an example of a typical MFC project's Stdafx.h file. This project uses the common controls. For example:

   #define VC_EXTRALEAN   // Exclude rarely-used stuff from Windows headers

   #include <macname1.h>
   #define OLDROUTINENAMES 0
   #include <macos/windows.h>
   #include <macname2.h>

   #include <afxwin.h>  // includes Winwlm.h
   #include <afxext.h>
   #include <afxcmn.h>