Passing a Pointer to a Member Function to the Win32 API

• Microsoft Win32 Application Programming Interface (API) included with:

      - Microsoft Windows NT versions 3.1, 3.5, and 3.51
      - Microsoft Windows 95 version 4.0
  

SUMMARY

Many of the Win32 application programming interfaces (APIs) call for a callback routine. One example is the lpStartAddr argument of CreateThread():

   HANDLE CreateThread(lpsa, cbStack, lpStartAddr, lpvThreadParm,
      fdwCreate, lpIDThread)

   LPSECURITY_ATTRIBUTES lpsa;    /* Address of thread security attrs */
   DWORD cbStack;                    /* Initial thread stack size*/
   LPTHREAD_START_ROUTINE lpStartAddr; /* Address of thread function */
   LPVOID lpvThreadParm;       /* Argument for new thread*/
   DWORD fdwCreate;               /* Creation flags*/
   LPDWORD lpIDThread;               /* Address of returned thread ID */

   error C2643: illegal cast from pointer to member

If you want to use a member function as a callback, you can use a static member function. Static member functions do not receive the "this" pointer and their addresses correspond to an instruction to execute.

Static member functions can only access static data, and therefore to access nonstatic class members, the function needs an object or a pointer to an object. One solution is to pass in the "this" pointer as an argument to the member function.

MORE INFORMATION

This situation occurs with callback functions of other types as well, such as:

   DLGPROC                  GRAYSTRINGPROC
   EDITWORDBREAKPROC        LINEDDAPROC
   ENHMFENUMPROC            MFENUMPROC
   ENUMRESLANGPROC          PROPENUMPROC
   ENUMRESNAMEPROC          PROPENUMPROCEX
   ENUMRESTYPEPROC          TIMERPROC
   FONTENUMPROC             WNDENUMPROC
   GOBJENUMPROC

The following sample demonstrates how to use a static member function as a thread function, and pass in the "this" pointer as an argument.

Sample Code

#include <windows.h>

   int x;
   int y;

   A() { x = 0; y = 0; }

   static StartRoutine( A * );   // Compiles clean, includes "this" pointer
};

void main( )

   A a;

   DWORD dwThreadID;

   CreateThread( NULL,
      0,
      (LPTHREAD_START_ROUTINE)(a.StartRoutine),
      &a,                        // Pass "this" pointer to static member fn
      0,
      &dwThreadID
   );