GetGuiResources Overview  Group

The GetGuiResources function returns the count of handles to graphical user interface (GUI) objects in use by the specified process.

DWORD GetGuiResource (

HANDLE hProcess,	// identifies the process of interest
DWORD uiFlags	// indicates the GUI object type
);

Parameters

hProcess

Handle to the process. The handle must have the PROCESS_QUERY_INFORMATION access right. For information on this access right, see Process Objects.

uiFlags

Specifies the GUI object type. You can specify one of the following values:

Value	Meaning
GR_GDIOBJECTS	Return the count of GDI objects.
GR_USEROBJECTS	Return the count of USER objects.

Return Values

If the function succeeds, the return value is the count of handles to GUI objects in use by the process. If no GUI objects are in use, the return value is zero.

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

Remarks

A process without a graphical user interface does not use GUI resources, therefore, GetGuiResources will return zero.

See Also

CreateProcess, GetCurrentProcess, OpenProcess