Fungsi GetGuiResources (winuser.h)

Artikel
03/08/2023

Mengambil jumlah handel ke objek antarmuka pengguna grafis (GUI) yang digunakan oleh proses yang ditentukan.

Sintaks

DWORD GetGuiResources(
  [in] HANDLE hProcess,
  [in] DWORD  uiFlags
);

Parameter

[in] hProcess

Handel untuk proses. Handel harus mengacu pada proses dalam sesi saat ini, dan harus memiliki hak akses PROCESS_QUERY_LIMITED_INFORMATION (lihat Keamanan proses dan hak akses).

Jika parameter ini adalah nilai khusus GR_GLOBAL, maka penggunaan sumber daya dilaporkan di semua proses dalam sesi saat ini.

Windows Server 2008, Windows Vista, Windows Server 2003, dan Windows XP: Nilai GR_GLOBAL tidak didukung hingga Windows 7 dan Windows Server 2008 R2.

Windows Server 2003 dan Windows XP: Handel harus memiliki hak akses PROCESS_QUERY_INFORMATION .

[in] uiFlags

Jenis objek GUI. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
GR_GDIOBJECTS 0	Mengembalikan jumlah objek GDI.
GR_GDIOBJECTS_PEAK 2	Mengembalikan jumlah puncak objek GDI. Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP: Nilai ini tidak didukung sampai Windows 7 dan Windows Server 2008 R2.
GR_USEROBJECTS 1	Mengembalikan jumlah objek USER.
GR_USEROBJECTS_PEAK 4	Mengembalikan jumlah puncak objek USER. Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP: Nilai ini tidak didukung sampai Windows 7 dan Windows Server 2008 R2.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah jumlah handel ke objek GUI yang digunakan oleh proses. Jika tidak ada objek GUI yang digunakan, nilai yang dikembalikan adalah nol.

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

Keterangan

Proses tanpa antarmuka pengguna grafis tidak menggunakan sumber daya GUI, oleh karena itu, GetGuiResources akan mengembalikan nol.

Persyaratan


Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	winuser.h (termasuk windows.h)
Pustaka	User32.lib
DLL	User32.dll
Set API	ext-ms-win-ntuser-misc-l1-1-0 (diperkenalkan dalam Windows 8)

Lihat juga

CreateProcess

GetCurrentProcess

OpenProcess

Fungsi Proses dan Utas

Bagikan melalui