LocalNext

3.1

  #include <toolhelp.h>    

  BOOL LocalNext(lple)    
  LOCALENTRY FAR* lple; /* address of LOCALENTRY structure */

The LocalNext function fills the specified structure with information that describes the next object on the local heap.

Parameters

lple

Points to a LOCALENTRY structure that will receive information about the local memory object. The LOCALENTRY structure has the following form:

#include <toolhelp.h>

typedef struct tagLOCALENTRY {  /* le */
    DWORD   dwSize;
    HLOCAL  hHandle;
    WORD    wAddress;
    WORD    wSize;
    WORD    wFlags;
    WORD    wcLock;
    WORD    wType;
    WORD    hHeap;
    WORD    wHeapType;
    WORD    wNext;
} LOCALENTRY;

For a full description of this structure, see the Microsoft Windows Programmer's Reference, Volume 3.

Return Value

The return value is nonzero if the function is successful. Otherwise, it is zero.

Comments

The LocalNext function can be used to continue a local heap walk started by the LocalFirst function.

See Also

LocalFirst, LocalInfo