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
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows 8 [Desktop-Apps | UWP-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2012 [Desktop-Apps | UWP-Apps] |
Zielplattform | Windows |
Kopfzeile | processthreadsapi.h (include Windows.h) |
Bibliothek | Kernel32.lib |
DLL | Kernel32.dll |
Siehe auch
GetThreadInformation-Funktion, MEMORY_PRIORITY_INFORMATION-Struktur, SetProcessInformation-Funktion, PROCESS_INFORMATION_CLASS-Enumeration, OVERRIDE_PREFETCH_PARAMETER-Struktur