Метод IDebugClient2::GetRunningProcessSystemIdByExecutableName (dbgeng.h)

Статья
02/23/2024

Метод GetRunningProcessSystemIdByExecutableName ищет процесс с заданным именем исполняемого файла и возвращает его идентификатор процесса.

Синтаксис

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

Параметры

[in] Server

Указывает сервер обработки для поиска имени исполняемого файла. Если сервер равен нулю, подсистема будет искать имя исполняемого файла среди процессов, выполняющихся на локальном компьютере.

[in] ExeName

Указывает имя исполняемого файла, по которому выполняется поиск.

[in] Flags

Задает битовый набор, определяющий, как сопоставляется имя исполняемого файла. Могут присутствовать следующие флаги:

Flag	Описание
DEBUG_GET_PROC_FULL_MATCH	ExeName указывает полный путь к имени исполняемого файла. Если этот флаг не установлен, этот метод не будет использовать имена путей при поиске процесса.
DEBUG_GET_PROC_ONLY_MATCH	Требуется, чтобы только один процесс соответствовал имени исполняемого файла ExeName.

[out] Id

Получает идентификатор первого процесса, соответствующего ExeName.

Возвращаемое значение

Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в разделе Возвращаемые значения .

Код возврата	Описание
S_OK	Метод выполнен успешно.
S_FALSE	Несколько процессов совпадают с именем исполняемого файла в ExeName, а DEBUG_GET_PROC_ONLY_MATCH задано в разделе Флаги.
E_NOINTERFACE	Имя исполняемого файла в exeName не совпадает с именем исполняемого файла.