| HeapPtrToHandle | Function (ROM Call 0x23A)

alloc.h

HANDLE HeapPtrToHandle (void *Ptr);

Determines the handle associated with a block.

HeapPtrToHandle returns the handle which is associated with a block that is pointed to by Ptr (or H_NULL if there is not a handle that references the given block). This routine works by searching the entire table of handles for the given pointer, and so should be used accordingly. It assumes that the heap has not been compressed since the dereferenced pointer was originally obtained or the block it points to is locked.