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 |