Función Thread32First (tlhelp32.h)

Artículo
03/05/2024

Recupera información sobre el primer subproceso de cualquier proceso encontrado en una instantánea del sistema.

Sintaxis

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

Parámetros

[in] hSnapshot

Identificador de la instantánea devuelta desde una llamada anterior a la función CreateToolhelp32Snapshot .

[in, out] lpte

Puntero a una estructura de THREADENTRY32 .

Valor devuelto

Devuelve TRUE si la primera entrada de la lista de subprocesos se ha copiado en el búfer o FALSE de lo contrario. La función GetLastError devuelve el valor de error ERROR_NO_MORE_FILES si no existe ningún subproceso o la instantánea no contiene información de subprocesos.

Comentarios

La aplicación que llama debe establecer el miembro dwSize de THREADENTRY32 en el tamaño, en bytes, de la estructura. Thread32First cambia dwSize al número de bytes escritos en la estructura. Esto nunca será mayor que el valor inicial de dwSize, pero puede ser más pequeño. Si el valor es menor, no se base en los valores de ningún miembro cuyo desplazamiento sea mayor que este valor.

Para recuperar información sobre otros subprocesos registrados en la misma instantánea, use la función Thread32Next .

Ejemplos

Para obtener un ejemplo, vea Recorrer la lista de subprocesos.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	tlhelp32.h
Library	Kernel32.lib
Archivo DLL	Kernel32.dll