Fungsi GetProcessInformation (processthreadsapi.h)

Artikel
02/05/2024

Mengambil informasi tentang proses yang ditentukan.

Sintaks

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

Parameter

[in] hProcess

Handel untuk proses. Handel ini harus memiliki setidaknya hak akses PROCESS_QUERY_LIMITED_INFORMATION . Untuk informasi selengkapnya, lihat Keamanan Proses dan Hak Akses.

[in] ProcessInformationClass

Anggota enumerasi PROCESS_INFORMATION_CLASS yang menentukan jenis informasi yang akan diambil.

ProcessInformation

Arahkan ke objek untuk menerima jenis informasi yang ditentukan oleh parameter ProcessInformationClass .

Jika parameter ProcessInformationClass adalah ProcessMemoryPriority, parameter ini harus menunjuk ke struktur MEMORY_PRIORITY_INFORMATION.

Jika parameter ProcessInformationClass adalah ProcessPowerThrottling, parameter ini harus menunjuk ke struktur PROCESS_POWER_THROTTLING_STATE.

Jika parameter ProcessInformationClass adalah ProcessProtectionLevelInfo, parameter ini harus menunjuk ke struktur PROCESS_PROTECTION_LEVEL_INFORMATION.

Jika parameter ProcessInformationClass adalah ProcessLeapSecondInfo, parameter ini harus menunjuk ke struktur PROCESS_LEAP_SECOND_INFO.

Jika parameter ProcessInformationClass adalah ProcessAppMemoryInfo, parameter ini harus menunjuk ke struktur APP_MEMORY_INFORMATION.

Jika parameter ProcessInformationClass adalah ProcessMaxOverridePrefetchParameter, parameter ini harus menunjuk ke struktur OVERRIDE_PREFETCH_PARAMETER.

[in] ProcessInformationSize

Ukuran dalam byte struktur yang ditentukan oleh parameter ProcessInformation .

Jika parameter ProcessInformationClass adalah ProcessMemoryPriority, parameter ini harus sizeof(MEMORY_PRIORITY_INFORMATION).

Jika parameter ProcessInformationClass adalah ProcessPowerThrottling, parameter ini harus sizeof(PROCESS_POWER_THROTTLING_STATE).

Jika parameter ProcessInformationClass adalah ProcessProtectionLevelInfo, parameter ini harus sizeof(PROCESS_PROTECTION_LEVEL_INFORMATION).

Jika parameter ProcessInformationClass adalah ProcessLeapSecondInfo, parameter ini harus sizeof(PROCESS_LEAP_SECOND_INFO).

Jika parameter ProcessInformationClass adalah ProcessAppMemoryInfo, parameter ini harus sizeof(APP_MEMORY_INFORMATION).

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, panggil fungsi GetLastError.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2012 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	processthreadsapi.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

Fungsi GetThreadInformation, struktur MEMORY_PRIORITY_INFORMATION, fungsi SetProcessInformation, enumerasi PROCESS_INFORMATION_CLASS, struktur OVERRIDE_PREFETCH_PARAMETER

Bagikan melalui