Función Process32First (tlhelp32.h)

Artículo
03/05/2024

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