Función Process32First (tlhelp32.h)
Recupera información sobre el primer proceso encontrado en una instantánea del sistema.
Sintaxis
BOOL Process32First(
[in] HANDLE hSnapshot,
[in, out] LPPROCESSENTRY32 lppe
);
Parámetros
[in] hSnapshot
Identificador de la instantánea devuelta desde una llamada anterior a la función CreateToolhelp32Snapshot .
[in, out] lppe
Puntero a una estructura PROCESSENTRY32 . Contiene información de proceso como el nombre del archivo ejecutable, el identificador de proceso y el identificador de proceso del proceso primario.
Valor devuelto
Devuelve TRUE si la primera entrada de la lista de procesos se ha copiado en el búfer o FALSE en caso contrario. La función GetLastError devuelve el valor de error ERROR_NO_MORE_FILES si no existe ningún proceso o la instantánea no contiene información de proceso.
Comentarios
La aplicación que llama debe establecer el miembro dwSize de PROCESSENTRY32 en el tamaño, en bytes, de la estructura.
Para recuperar información sobre otros procesos registrados en la misma instantánea, use la función Process32Next .
Ejemplos
Para obtener un ejemplo, vea Tomar una instantánea y ver procesos.
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 |