Поделиться через

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

  • Статья

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

Синтаксис

BOOL QueryFullProcessImageNameW(
  [in]      HANDLE hProcess,
  [in]      DWORD  dwFlags,
  [out]     LPWSTR 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.

Комментарии

Чтобы скомпилировать приложение, использующее эту функцию, определите _WIN32_WINNT как 0x0600 или более поздней версии.

Примечание

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

Требования

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

См. также

GetModuleFileNameEx

GetProcessImageFileName

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