Método IDebugClient5::GetRunningProcessSystemIdByExecutableNameWide (dbgeng.h)
El método GetRunningProcessSystemIdByExecutableNameWide busca un proceso con un nombre de archivo ejecutable determinado y devuelve su identificador de proceso.
Sintaxis
HRESULT GetRunningProcessSystemIdByExecutableNameWide(
[in] ULONG64 Server,
[in] PCWSTR 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:
| Bandera | Descripción |
|---|---|
| DEBUG_GET_PROC_FULL_MATCH |
ExeName especifica el nombre de ruta de acceso completo 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 información.
| Código devuelto | Descripción |
|---|---|
|
El método se realizó correctamente. |
|
Más de un proceso coincide con el nombre de archivo ejecutable en ExeNamey DEBUG_GET_PROC_ONLY_MATCH se estableció en Marcas. |
|
Ningún proceso coincide con el nombre de archivo ejecutable en ExeName. |
Observaciones
Este método solo está disponible para la depuración en modo usuario activo.
Para obtener más información sobre cómo crear y adjuntar destinos en modo de usuario activo, consulte Live User-Mode Targets.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | dbgeng.h (include Dbgeng.h) |