CreateToolhelp32Snapshot

9/8/2008

Essa função leva um instantâneo dos processos, pilhas, módulos e segmentos usados pelos processos.

Syntax

HANDLE WINAPI CreateToolhelp32Snapshot(
  DWORD dwFlags,
  DWORD th32ProcessID
);

Parameters

• dwFlags
  [no] Partes do sistema para incluir no instantâneo. A seguinte tabela mostra os valores possíveis.

  Valor	Descrição
  TH32CS_GETALLMODS	Inclui todos os módulos de instantâneo. Deve ser usado com o operador OR em combinação com TH32CS_SNAPMODULE.
  TH32CS_SNAPALL	Equivalente à especificação TH32CS_SNAPHEAPLIST, TH32CS_SNAPMODULE, TH32CS_SNAPPROCESS e TH32CS_SNAPTHREAD.
  TH32CS_SNAPHEAPLIST	Inclui a lista heap do processo especificado o instantâneo.
  TH32CS_SNAPMODULE	Inclui a lista módulo do processo especificado o instantâneo.
  TH32CS_SNAPNOHEAPS	Por padrão, informações heap de processo é incluídas quando criar instantâneo process. Para uma maneira mais eficiente de receber as informações básicas do processo, use este sinalizador com TH32CS_SNAPPROCESS.
  TH32CS_SNAPPROCESS	Inclui a lista processo o instantâneo.
  TH32CS_SNAPTHREAD	Inclui a lista segmento de instantâneo.

• th32ProcessID
  [no] Identificador do processo. Este parâmetro pode ser zero indicar o atual processo. Este parâmetro é usado quando TH32CS_SNAPHEAPLIST ou TH32CS_SNAPMODULE for especificada. Caso contrário, ele será ignorado.

Return Value

Um aberto identificador para o instantâneo especificado indica sucesso. INVALID_HANDLE_VALUE indica falha.

Remarks

O instantâneo retornado é um copiar do atual estado do sistema. Para fechar um instantâneo, chamar a função CloseToolhelp32Snapshot. Fazer não chamar a função CloseHandle para fechar a chamar instantâneo. Que gera um vazamento memória. O instantâneo tomado por essa função é examinado por outras funções da Ajuda ferramenta para fornecer seus resultados. Acesso ao instantâneo é somente leitura.

A instantâneo identificador funciona como um objeto identificador e é assunto às mesmas regras relacionadas a processos e seguimentos em que é válido. Para recuperar um estendido código de status de erro geradas por esta função, use a função GetLastError. Porque os dados capturados por CreateToolhelp32Snapshot é estático e o sistema é dinâmico, use tente-excepts em torno de APIs que acessar essa dados.

Requirements

Header	tlhelp32.h, toolhelp.h
Library	toolhelp.lib
Windows Embedded CE	Windows CE 2.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

ToolHelp Functions
CloseToolhelp32Snapshot
Process32First
Process32Next

Other Resources

CloseHandle