Skip to content

Latest commit

 

History

History
104 lines (76 loc) · 4.75 KB

nf-processthreadsapi-getprocessinformation.md

File metadata and controls

104 lines (76 loc) · 4.75 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:processthreadsapi.GetProcessInformation
GetProcessInformation function (processthreadsapi.h)
Retrieves information about the specified process. (GetProcessInformation)
GetProcessInformation
GetProcessInformation function
base.getprocessinformation
processthreadsapi/GetProcessInformation
base\getprocessinformation.htm
processthreadsapi
2b075405-b7b6-4da0-b78d-45eaa9c6c8cd
12/05/2018
GetProcessInformation, GetProcessInformation function, base.getprocessinformation, processthreadsapi/GetProcessInformation
processthreadsapi.h
Windows.h
Windows
Windows 8 [desktop apps \| UWP apps]
Windows Server 2012 [desktop apps \| UWP apps]
Kernel32.lib
Kernel32.dll
Windows
19H1
GetProcessInformation
processthreadsapi/GetProcessInformation
c++
APIRef
kbSyntax
DllExport
Kernel32.dll
API-MS-Win-Core-ProcessThreads-L1-1-3.dll
KernelBase.dll
GetProcessInformation

GetProcessInformation function

-description

Retrieves information about the specified process.

-parameters

-param hProcess [in]

A handle to the process. This handle must have at least the PROCESS_QUERY_LIMITED_INFORMATION access right. For more information, see Process Security and Access Rights.

-param ProcessInformationClass [in]

A member of the PROCESS_INFORMATION_CLASS enumeration specifying the kind of information to retrieve.

-param ProcessInformation

Pointer to an object to receive the type of information specified by the ProcessInformationClass parameter.

If the ProcessInformationClass parameter is ProcessMemoryPriority, this parameter must point to a MEMORY_PRIORITY_INFORMATION structure.

If the ProcessInformationClass parameter is ProcessPowerThrottling, this parameter must point to a PROCESS_POWER_THROTTLING_STATE structure.

If the ProcessInformationClass parameter is ProcessProtectionLevelInfo, this parameter must point to a PROCESS_PROTECTION_LEVEL_INFORMATION structure.

If the ProcessInformationClass parameter is ProcessLeapSecondInfo, this parameter must point to a PROCESS_LEAP_SECOND_INFO structure.

If the ProcessInformationClass parameter is ProcessAppMemoryInfo, this parameter must point to a APP_MEMORY_INFORMATION structure.

If the ProcessInformationClass parameter is ProcessMaxOverridePrefetchParameter, this parameter must point to an OVERRIDE_PREFETCH_PARAMETER structure.

-param ProcessInformationSize [in]

The size in bytes of the structure specified by the ProcessInformation parameter.

If the ProcessInformationClass parameter is ProcessMemoryPriority, this parameter must be sizeof(MEMORY_PRIORITY_INFORMATION).

If the ProcessInformationClass parameter is ProcessPowerThrottling, this parameter must be sizeof(PROCESS_POWER_THROTTLING_STATE).

If the ProcessInformationClass parameter is ProcessProtectionLevelInfo, this parameter must be sizeof(PROCESS_PROTECTION_LEVEL_INFORMATION).

If the ProcessInformationClass parameter is ProcessLeapSecondInfo, this parameter must be sizeof(PROCESS_LEAP_SECOND_INFO).

If the ProcessInformationClass parameter is ProcessAppMemoryInfo, this parameter must be sizeof(APP_MEMORY_INFORMATION).

-returns

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError function.

-see-also

GetThreadInformation function, MEMORY_PRIORITY_INFORMATION structure, SetProcessInformation function, PROCESS_INFORMATION_CLASS enumeration, OVERRIDE_PREFETCH_PARAMETER structure