Метод IDebugClient3::GetRunningProcessSystemIdByExecutableNameWide (dbgeng.h)

Статья
02/23/2024

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

Синтаксис

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

Параметры

[in] Server

Указывает сервер обработки для поиска имени исполняемого файла. Если значение 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 не совпадает.