Função Thread32First (tlhelp32.h)

Artigo
03/02/2024

Recupera informações sobre o primeiro thread de qualquer processo encontrado em um sistema instantâneo.

Sintaxe

BOOL Thread32First(
  [in]      HANDLE          hSnapshot,
  [in, out] LPTHREADENTRY32 lpte
);

Parâmetros

[in] hSnapshot

Um identificador para o instantâneo retornado de uma chamada anterior para a função CreateToolhelp32Snapshot.

[in, out] lpte

Um ponteiro para uma estrutura THREADENTRY32 .

Retornar valor

Retornará TRUE se a primeira entrada da lista de threads tiver sido copiada para o buffer ou FALSE caso contrário. O valor de erro ERROR_NO_MORE_FILES será retornado pela função GetLastError se nenhum thread existir ou o instantâneo não contiver informações de thread.

Comentários

O aplicativo de chamada deve definir o membro dwSize de THREADENTRY32 para o tamanho, em bytes, da estrutura. Thread32First altera dwSize para o número de bytes gravados na estrutura. Isso nunca será maior do que o valor inicial de dwSize, mas pode ser menor. Se o valor for menor, não dependa dos valores de nenhum membro cujos deslocamentos sejam maiores que esse valor.

Para recuperar informações sobre outros threads registrados no mesmo instantâneo, use a função Thread32Next.

Exemplos

Para obter um exemplo, consulte Atravessando a lista de threads.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	tlhelp32.h
Biblioteca	Kernel32.lib
DLL	Kernel32.dll