_set_purecall_handler
Sets the handler for a pure virtual function call.
_purecall_handler _set_purecall_handler(
_purecall_handler function
);
Parameters
- function
The function to be called when a pure virtual function is called. A _purecall_handler function must have a void return type.
Return Value
The previous _purecall_handler. Returns NULL if there was no previous handler.
Remarks
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 a NULL argument.
Requirements
Routine |
Required header |
|---|---|
_set_purecall_handler |
<stdlib.h> |
For more compatibility information, see Compatibility in the Introduction.
Example
// _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.
.NET Framework Equivalent
Not applicable. To call the standard C function, use PInvoke. For more information, see Platform Invoke Examples.