Método IDebugClient3::GetRunningProcessSystemIdByExecutableName (dbgeng.h)

Artículo
02/23/2024

El método GetRunningProcessSystemIdByExecutableName busca un proceso con un nombre de archivo ejecutable determinado y devuelve su identificador de proceso.

Sintaxis

HRESULT GetRunningProcessSystemIdByExecutableName(
  [in]  ULONG64 Server,
  [in]  PCSTR   ExeName,
  [in]  ULONG   Flags,
  [out] PULONG  Id
);

Parámetros

[in] Server

Especifica el servidor de procesos que se va a buscar el nombre ejecutable. Si Server es cero, el motor buscará el nombre ejecutable entre los procesos que se ejecutan en el equipo local.

[in] ExeName

Especifica el nombre de archivo ejecutable para el que se va a buscar.

[in] Flags

Especifica un conjunto de bits que controla cómo coincide el nombre del archivo ejecutable. Las marcas siguientes pueden estar presentes:

Marca	Descripción
DEBUG_GET_PROC_FULL_MATCH	ExeName especifica el nombre completo de la ruta de acceso del nombre de archivo ejecutable. Si no se establece esta marca, este método no usará nombres de ruta de acceso al buscar el proceso.
DEBUG_GET_PROC_ONLY_MATCH	Requerir que solo un proceso coincida con el nombre de archivo ejecutable ExeName.

[out] Id

Recibe el identificador de proceso del primer proceso para que coincida con ExeName.

Valor devuelto

Este método también puede devolver valores de error. Consulte Valores devueltos para obtener más detalles.

Código devuelto	Descripción
S_OK	Método realizado correctamente.
S_FALSE	Más de un proceso coincide con el nombre de archivo ejecutable en ExeName y DEBUG_GET_PROC_ONLY_MATCH se estableció en Flags.
E_NOINTERFACE	Ningún proceso coincide con el nombre del archivo ejecutable en ExeName.