Compartir a través de


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

Vea también

CreateToolhelp32Snapshot

PROCESSENTRY32

Proceso caminando

Process32Next

Funciones de ayuda de herramientas