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

Статья
02/06/2025

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

Синтаксис

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

Параметры

[in] Server

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

[in] ExeName

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

[in] Flags

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

Флаг	Описание
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не соответствует имени исполняемого файла.