BOOL PASCAL AfxIsMemoryBlock( const void* p, UINT nBytes, LONG* plRequestNumber = NULL );
p
A void pointer to the block of memory to be tested.
nBytes
The length of the memory block in bytes.
plRequestNumber
A pointer to a long integer that will be filled in with the memory block's allocation sequence number. The variable pointed to by plRequestNumber will only be filled in if AfxIsMemoryBlock returns TRUE.
Tests a memory address to make sure it represents a currently active memory block that was allocated by the diagnostic version of new. It also checks the specified size against the original allocated size. The allocation sequence number that is returned in plRequestNumber if the function returns TRUE is the order in which the block was allocated relative to all other new allocations.
TRUE if the memory block is currently allocated and the length is correct; otherwise FALSE.
CAge* pcage = new CAge( 21 ); // CAge is derived from CObject
if( AfxIsMemoryBlock( pcage, sizeof( CAge ) ) != TRUE )
exit( 1 ); // Invalid memory