Compartir a través de


Función Thread32First (tlhelp32.h)

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

Vea también

CreateToolhelp32Snapshot

THREADENTRY32

Caminar por subprocesos

Thread32Next

Funciones de ayuda de herramientas