snapshot

CreateToolhelp32Snapshot

2015. 3. 16. 12:39

지정한 또는 모든 프로세스의 스냅샷 정보를 생성한다.

* 스냅샷이란 사진을 찍듯 함수가 호출된 시점에 지정한 대상의 정보를 저장해 놓은것을 말한다. 

  스냅샷 정보로는 프로세스 정보뿐만 아니라 힙, 모듈, 스레드 정보도 생성 가능하다.

 

 

- 출처 : MSDN

 

  • dwFlags

- 생성 할 스냅샷 종류를 설정 한다.

- 프로세스 목록을 열거하기 위해서는 TH32CS_SNAPPROCESS를 사용한다.

- 스레드 목록을 열거하기 위해서는 TH32CS_SNAPTHREAD를 사용한다.

 

  • th32ProcessID

- 스냅샷 정보를 생성 할 대상을 지정한다, 일반적으로 모든 프로세스의 정보를 원하면 0을 설정한다.

- 첫 번째 파라메터의 인자로 TH32CS_SNAPHEAPLIST, TH32CS_SNAPMODULE, TH32CS_SNAPMODULE32, TH32CS_SNAPALL 값들 중 하나가 선택되면 현재 파라메터에 특정 프로세스의 ID를 설정 한다, 이 때의 0은 현재 프로세스를 나타낸다. 

 

Return value : 성공 시 생성된 스냅샷 정보에 접근하기 위한 핸들이 반환되고, 실패 시 INVALID_HANDLE_VALUE(-1)를 반환한다. 실패에 대한 자세한 정보는 GetLastError 함수를 참고한다.

 

Header : TlHelp32.h 

 

DLL : Kernel32.dll


'Win32 API' 카테고리의 다른 글

Process32First  (0) 2015.03.16
CloseHandle  (0) 2015.03.16
GetTempPath  (0) 2015.03.12
GetWindowsDirectory  (0) 2015.03.12
GetSystemDirectory  (0) 2015.03.12

+ Recent posts