Функция QueryFullProcessImageNameA (winbase.h)

Статья
03/09/2024

Извлекает полное имя исполняемого образа для указанного процесса.

Синтаксис

BOOL QueryFullProcessImageNameA(
  [in]      HANDLE hProcess,
  [in]      DWORD  dwFlags,
  [out]     LPSTR  lpExeName,
  [in, out] PDWORD lpdwSize
);

Параметры

[in] hProcess

Дескриптор процесса. Этот дескриптор должен быть создан с правом доступа PROCESS_QUERY_INFORMATION или PROCESS_QUERY_LIMITED_INFORMATION. Дополнительные сведения см. в разделе Управление правами на доступ и безопасность процесса.

[in] dwFlags

Этот параметр может принимать одно из указанных ниже значений.

Значение	Значение
0	Имя должно использовать формат пути Win32.
PROCESS_NAME_NATIVE 0x00000001	Имя должно использовать собственный формат системного пути.

[out] lpExeName

Путь к исполняемому образу. Если функция выполняется успешно, эта строка завершается null.

[in, out] lpdwSize

На входных данных указывает размер буфера lpExeName в символах. При успешном выполнении получает количество символов, записанных в буфер, не включая завершающий символ null.

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

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Заголовок winbase.h определяет QueryFullProcessImageName в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	winbase.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll

См. также

GetModuleFileNameEx

GetProcessImageFileName

Функции процессов и потоков