Функция GetProcessInformation (processthreadsapi.h)

Статья
02/05/2024

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

Синтаксис

BOOL GetProcessInformation(
  [in] HANDLE                    hProcess,
  [in] PROCESS_INFORMATION_CLASS ProcessInformationClass,
       LPVOID                    ProcessInformation,
  [in] DWORD                     ProcessInformationSize
);

Параметры

[in] hProcess

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

[in] ProcessInformationClass

Элемент перечисления PROCESS_INFORMATION_CLASS , указывающий тип извлекаемой информации.

ProcessInformation

Указатель на объект для получения типа информации, указанного параметром ProcessInformationClass .

Если параметр ProcessInformationClass имеет значение ProcessMemoryPriority, этот параметр должен указывать на MEMORY_PRIORITY_INFORMATION структуру.

Если параметр ProcessInformationClass имеет значение ProcessPowerThrottling, этот параметр должен указывать на PROCESS_POWER_THROTTLING_STATE структуру.

Если параметр ProcessInformationClass имеет значение ProcessProtectionLevelInfo, этот параметр должен указывать на PROCESS_PROTECTION_LEVEL_INFORMATION структуру.

Если параметр ProcessInformationClass имеет значение ProcessLeapSecondInfo, этот параметр должен указывать на PROCESS_LEAP_SECOND_INFO структуру.

Если параметр ProcessInformationClass имеет значение ProcessAppMemoryInfo, этот параметр должен указывать на APP_MEMORY_INFORMATION структуру.

Если параметр ProcessInformationClass имеет значение ProcessMaxOverridePrefetchParameter, этот параметр должен указывать на OVERRIDE_PREFETCH_PARAMETER структуру.

[in] ProcessInformationSize

Размер структуры в байтах, заданной параметром ProcessInformation .

Если параметр ProcessInformationClass имеет значение ProcessMemoryPriority, этот параметр должен иметь значение sizeof(MEMORY_PRIORITY_INFORMATION).

Если параметр ProcessInformationClass имеет значение ProcessPowerThrottling, этот параметр должен иметь значение sizeof(PROCESS_POWER_THROTTLING_STATE).

Если параметр ProcessInformationClass имеет значение ProcessProtectionLevelInfo, этот параметр должен иметь значение sizeof(PROCESS_PROTECTION_LEVEL_INFORMATION).

Если параметр ProcessInformationClass имеет значение ProcessLeapSecondInfo, этот параметр должен иметь значение sizeof(PROCESS_LEAP_SECOND_INFO).

Если параметр ProcessInformationClass имеет значение ProcessAppMemoryInfo, этот параметр должен иметь значение sizeof(APP_MEMORY_INFORMATION).

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

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

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 8 [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2012 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	processthreadsapi.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll

См. также

Функция GetThreadInformation, структура MEMORY_PRIORITY_INFORMATION, функция SetProcessInformation, перечисление PROCESS_INFORMATION_CLASS , структура OVERRIDE_PREFETCH_PARAMETER

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