Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
div
eof
Expand Minimize

_set_purecall_handler, _set_purecall_handler_m

Sets the handler for a pure virtual function call.

_purecall_handler _set_purecall_handler(  
   _purecall_handler function 
); 
_purecall_handler _set_purecall_handler_m(  
   _purecall_handler_mfunction 
);

function

The function to be called when a pure virtual function is called. A _purecall_handler or _purecall_handler_m function should have a void return type.

The previous _purecall_handler. Returns NULL if there was no previous handler.

Use _set_purecall_handler if you want to catch pure virtual functions and report them to the user in a specific way or catch them for debugging purposes.

Because there is one _purecall_handler for the whole process, calling this function immediately impacts all threads. The last caller on any thread sets the handler.

There is a single _set_purecall_handler handler for all dynamically linked DLLs or executables; even if you call _set_purecall_handler your handler may be replaced by another or that you are replacing a handler set by another DLL or executable.

To restore default behavior, call _set_purecall_handler with aNULL argument.

The _set_purecall_handler_m version of the function is for mixed mode CRT.

Routine

Required header

_set_purecall_handler ,

_set_purecall_handler_m

<stdlib.h>

For more compatibility information, see Compatibility in the Introduction.

// _set_purecall_handler.cpp
// compile with: /W1
#include <tchar.h>
#include <stdio.h>
#include <stdlib.h>

class CDerived;
class CBase
{
public:
   CBase(CDerived *derived): m_pDerived(derived) {};
   ~CBase();
   virtual void function(void) = 0;

   CDerived * m_pDerived;
};

class CDerived : public CBase
{
public:
   CDerived() : CBase(this) {};   // C4355
   virtual void function(void) {};
};

CBase::~CBase()
{
   m_pDerived -> function();
}

void myPurecallHandler(void)
{
   printf("In _purecall_handler.");
   exit(0);
}

int _tmain(int argc, _TCHAR* argv[])
{
   _set_purecall_handler(myPurecallHandler);
   CDerived myDerived;
}
In _purecall_handler.

Not applicable. To call the standard C function, use PInvoke. For more information, see Platform Invoke Examples.

Show:
© 2015 Microsoft