GetProcessInformation-Funktion (processthreadsapi.h)

Ruft Informationen zum angegebenen Prozess ab.

Syntax

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

Parameter

[in] hProcess

Ein Handle für den Prozess. Dieses Handle muss mindestens über das zugriffsrecht PROCESS_QUERY_LIMITED_INFORMATION verfügen. Weitere Informationen finden Sie unter Prozesssicherheit und Zugriffsrechte.

[in] ProcessInformationClass

Ein Member der PROCESS_INFORMATION_CLASS-Enumeration , die die Art der abzurufenden Informationen angibt.

ProcessInformation

Zeiger auf ein -Objekt, um den Typ von Informationen zu empfangen, die durch den Parameter ProcessInformationClass angegeben werden.

Wenn der Parameter ProcessInformationClassProcessMemoryPriority lautet, muss dieser Parameter auf eine MEMORY_PRIORITY_INFORMATION-Struktur verweisen.

Wenn der ProcessInformationClass-ParameterProcessPowerThrottling ist, muss dieser Parameter auf eine PROCESS_POWER_THROTTLING_STATE-Struktur verweisen.

Wenn der ProcessInformationClass-ParameterProcessProtectionLevelInfo ist, muss dieser Parameter auf eine PROCESS_PROTECTION_LEVEL_INFORMATION-Struktur verweisen.

Wenn der Parameter ProcessInformationClassProcessLeapSecondInfo lautet, muss dieser Parameter auf eine PROCESS_LEAP_SECOND_INFO-Struktur verweisen.

Wenn der ProcessInformationClass-ParameterProcessAppMemoryInfo lautet, muss dieser Parameter auf eine APP_MEMORY_INFORMATION-Struktur verweisen.

Wenn der Parameter ProcessInformationClassProcessMaxOverridePrefetchParameter ist, muss dieser Parameter auf eine OVERRIDE_PREFETCH_PARAMETER-Struktur verweisen.

[in] ProcessInformationSize

Die Größe der durch den Parameter ProcessInformation angegebenen Struktur in Byte.

Wenn der ProcessInformationClass-ParameterProcessMemoryPriority ist, muss dieser Parameter sein sizeof(MEMORY_PRIORITY_INFORMATION).

Wenn der ProcessInformationClass-ParameterProcessPowerThrottling ist, muss dieser Parameter sein sizeof(PROCESS_POWER_THROTTLING_STATE).

Wenn der ProcessInformationClass-ParameterProcessProtectionLevelInfo ist, muss dieser Parameter sein sizeof(PROCESS_PROTECTION_LEVEL_INFORMATION).

Wenn der ProcessInformationClass-ParameterProcessLeapSecondInfo ist, muss dieser Parameter sein sizeof(PROCESS_LEAP_SECOND_INFO).

Wenn der ProcessInformationClass-ParameterProcessAppMemoryInfo lautet, muss dieser Parameter sein sizeof(APP_MEMORY_INFORMATION).

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Rufen Sie die GetLastError-Funktion auf, um erweiterte Fehlerinformationen zu erhalten.

Anforderungen

Siehe auch

GetThreadInformation-Funktion, MEMORY_PRIORITY_INFORMATION-Struktur, SetProcessInformation-Funktion, PROCESS_INFORMATION_CLASS-Enumeration, OVERRIDE_PREFETCH_PARAMETER-Struktur