Windows ToolHelp Library
[Libraries]

---

Detailed Description

Created: 20th May 2006 Updated: 13th March 2007.

This library provides facilities for accessing system information via the Windows TOOLHELP API.

The library provides facilities for enumerating process, thread, module and heap information from the system:

• The winstl::heap_sequence class is used to enumerate the heaps in a process.
• The winstl::module_sequence class is used to enumerate the modules in a process.
• The winstl::heap_sequence class is used to enumerate the processes in the system.
• The winstl::thread_sequence class is used to enumerate the processes in a process.

Note:

The Windows ToolHelp library was written and kindly contributed by STLSoft-power user Pablo Aguilar.

Classes
struct	toolhelp_exception
	Root exception thrown by the ToolHelp Library. More...
class	th_sequence_const_iterator
	Iterator class for the th_sequence_base class template and its specialisations. More...
struct	sequence_doesnt_use_pid
	[IMPLEMENTATION] A utility class template that is used to to block the non-default constructor for specialisations of th_sequence_base that do not require the process Id. More...
class	th_sequence_base
	Class template for TOOLHELP STL collections. More...
Typedefs
typedef th_sequence_base < HEAPLIST32 >	heap_sequence
	An STL collection for accessing heap information.
typedef th_sequence_base < MODULEENTRY32 >	module_sequence
	An STL collection for accessing module information for a given process.
typedef th_sequence_base < PROCESSENTRY32 >	process_sequence
	An STL collection for accessing process information.
typedef th_sequence_base < THREADENTRY32 >	thread_sequence
	An STL collection for accessing thread information for a given process.
Functions
DWORD	get_pid (HEAPLIST32 const &hl)
	Attribute shim for retrieving the process id associated with the HEAPLIST32 instance.
DWORD	get_pid (MODULEENTRY32 const &me)
	Attribute shim for retrieving the process id associated with the MODULEENTRY32 instance.
DWORD	get_pid (PROCESSENTRY32 const &pe)
	Attribute shim for retrieving the process id associated with the PROCESSENTRY32 instance.
DWORD	get_pid (THREADENTRY32 const &te)
	Attribute shim for retrieving the process id associated with the THREADENTRY32 instance.

---

Typedef Documentation

typedef th_sequence_base<HEAPLIST32> heap_sequence

An STL collection for accessing heap information.

typedef th_sequence_base<MODULEENTRY32> module_sequence

An STL collection for accessing module information for a given process.

typedef th_sequence_base<PROCESSENTRY32> process_sequence

An STL collection for accessing process information.

typedef th_sequence_base<THREADENTRY32> thread_sequence

An STL collection for accessing thread information for a given process.

---

Function Documentation

DWORD winstl::get_pid

(

THREADENTRY32 const &

te

)

[inline]

Attribute shim for retrieving the process id associated with the THREADENTRY32 instance.

Parameters:

te

The THREADENTRY32 instance

DWORD winstl::get_pid

(

PROCESSENTRY32 const &

pe

)

[inline]

Attribute shim for retrieving the process id associated with the PROCESSENTRY32 instance.

Parameters:

pe

The PROCESSENTRY32 instance

DWORD winstl::get_pid

(

MODULEENTRY32 const &

me

)

[inline]

Attribute shim for retrieving the process id associated with the MODULEENTRY32 instance.

Parameters:

me

The MODULEENTRY32 instance

DWORD winstl::get_pid

(

HEAPLIST32 const &

hl

)

[inline]

Attribute shim for retrieving the process id associated with the HEAPLIST32 instance.

Parameters:

hl

The HEAPLIST32 instance