AfxSetAllocHook
Visual Studio .NET 2003
Sets a hook that enables calling of the specified function before each memory block is allocated.
AFX_ALLOC_HOOK AfxSetAllocHook( AFX_ALLOC_HOOK pfnAllocHook );
Parameters
- pfnAllocHook
- Specifies the name of the function to call. See the Remarks for the prototype of an allocation function.
Return Value
Nonzero if you want to permit the allocation; otherwise 0.
Remarks
The Microsoft Foundation Class Library debug-memory allocator can call a user-defined hook function to allow the user to monitor a memory allocation and to control whether the allocation is permitted. Allocation hook functions are prototyped as follows:
BOOL AFXAPI AllocHook( size_t nSize, BOOL bObject, LONG lRequestNumber );
- nSize
- The size of the proposed memory allocation.
- bObject
- TRUE if the allocation is for a CObject-derived object; otherwise FALSE.
- lRequestNumber
- The memory allocation's sequence number.
Note that the AFXAPI calling convention implies that the callee must remove the parameters from the stack.
