windows下进程快照CreateToolhelp32Snapshot()函数的使用

函数简介

​函数通过获取进程信息为指定的进程、进程使用的堆[HEAP]、模块[MODULE]、线程建立一个快照.

说到底，可以获取系统中正在运行的进程信息，线程信息，等

函数原型

HANDLE WINAPI CreateToolhelp32Snapshot(

DWORD dwFlags, //用来指定"快照"中需要返回的对象，可以是TH32CS_SNAPPROCESS等

DWORD th32ProcessID //一个进程ID号，用来指定要获取哪一个进程的快照，当获取系统进程列表或获取 当前进程快照时可以设为0

);

dwFlags

指定快照中包含的系统内容，这个参数能够使用下列数值(常量)中的一个或多个。

TH32CS_INHERIT - 声明快照句柄是可继承的。

TH32CS_SNAPALL - 在快照中包含系统中所有的进程和线程。

TH32CS_SNAPHEAPLIST - 在快照中包含在th32ProcessID中指定的进程的所有的堆。

TH32CS_SNAPMODULE - 在快照中包含在th32ProcessID中指定的进程的所有的模块。

TH32CS_SNAPPROCESS - 在快照中包含系统中所有的进程。

TH32CS_SNAPTHREAD - 在快照中包含系统中所有的线程。

Const TH32CS_SNAPHEAPLIST = &H1

Const TH32CS_SNAPPROCESS = &H2

Const TH32CS_SNAPTHREAD = &H4

Const TH32CS_SNAPMODULE = &H8

Const TH32CS_SNAPALL = (TH32CS_SNAPHEAPLIST | TH32CS_SNAPPROCESS | TH32CS_SNAPTHREAD | TH32CS_SNAPMODULE)

Const TH32CS_INHERIT = &H80000000

进程ID

指定将要快照的进程ID。如果该参数为0表示快照当前进程。该参数只有在设置了TH32CS_SNAPHEAPLIST或者TH32CS_SNAPMODULE后才有效，在其他情况下该参数被忽略，所有的进程都会被快照。

返回值

折叠解释

调用成功，返回快照的句柄，调用失败，返回INVALID_HANDLE_VALUE 。

折叠备注

使用GetLastError函数查找该函数产生的错误状态码。

注意，在Win NT中，要删除快照，使用CloseHandle函数;在Win CE中，要删除快照，使用CloseToolhelp32Snapshot函数。

使用实例

#include <stdio.h>
#include <stdlib.h>
#include <Windows.h>
#include <TlHelp32.h>

int main(int argc, char* argv[])
{
	HANDLE hProcessSnap = NULL;
	PROCESSENTRY32 pe32 = {0};

	//在使用这个结构前，先设置它的大小
	pe32.dwSize = sizeof(PROCESSENTRY32);

	//给系统内所有的进程拍个快照
	hProcessSnap = ::CreateToolhelp32Snapshot(TH32CS_SNAPPROCESS,0);
	if (hProcessSnap == INVALID_HANDLE_VALUE)
	{
		printf_s("CreatToolhelp32Snapshot error!\n");
		return -1;
	}

	//遍历进程快照，轮流显示每个进程的信息
	BOOL bRet = ::Process32First(hProcessSnap,&pe32);
	while (bRet)
	{
		printf_s("进程名称：%ls\n",pe32.szExeFile);   //这里得到的应该是宽字符，用%ls或者%S,不然无法正常打印
		printf_s("进程ID %u\n\n",pe32.th32ProcessID);
		bRet = ::Process32Next(hProcessSnap,&pe32);
	}

	//不要忘记清除掉snapshot对象
	::CloseHandle(hProcessSnap);
	return 0;
}