Microsoft KB Archive/102352

{|
 * width="100%"|

INFO: Passing a Pointer to a Member Function to the Win32 API

 * }

Q102352

4.00 | 3.10 3.50 3.51 WINDOWS | WINDOWS NT kbprg

-

The information in this article applies to:


 * Microsoft Win32 Application Programming Interface (API), used with:
 * Microsoft Windows NT Server versions 3.1, 3.5, 3.51
 * Microsoft Windows NT Workstation versions 3.1, 3.5, 3.51
 * Microsoft Windows 95

-

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 */

When attempting to use a member function as the thread function, the following error is generated:

  error C2643: illegal cast from pointer to member

The problem is that the function expects a C-style callback, not a pointer to a member function. A major difference is that member functions are called with a hidden argument called the "this" pointer. In addition, the format of the pointer isn't simply the address of the first machine instruction, as a C pointer is. This is particularly true for virtual functions.

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

For more information on C++ callbacks, please see the May 1993 issue of the "Windows Tech Journal."

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 &lt;windows.h&gt;

class A { public:

  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"    ); }

Additional query words: 3.10 3.50 4.00

Keywords :

Issue type : kbinfo

Technology : kbAudDeveloper kbWin32sSearch kbWin32API