Funzione GetGuiResources (winuser.h)

Recupera il conteggio degli handle in oggetti dell'interfaccia utente grafica (GUI) in uso dal processo specificato.

Sintassi

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

Parametri

[in] hProcess

Handle per il processo. L'handle deve fare riferimento a un processo nella sessione corrente e deve avere il diritto di accesso PROCESS_QUERY_LIMITED_INFORMATION (vedere Sicurezza del processo e diritti di accesso).

Se questo parametro è il valore speciale GR_GLOBAL, l'utilizzo delle risorse viene segnalato in tutti i processi della sessione corrente.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Il valore GR_GLOBAL non è supportato fino a Windows 7 e Windows Server 2008 R2.

Windows Server 2003 e Windows XP: L'handle deve avere il diritto di accesso PROCESS_QUERY_INFORMATION .

[in] uiFlags

Tipo di oggetto GUI. Questo parametro può avere uno dei valori seguenti.

Valore Significato
GR_GDIOBJECTS
0
Restituisce il conteggio degli oggetti GDI.
GR_GDIOBJECTS_PEAK
2
Restituisce il numero massimo di oggetti GDI.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è supportato fino a Windows 7 e Windows Server 2008 R2.

GR_USEROBJECTS
1
Restituisce il conteggio degli oggetti USER.
GR_USEROBJECTS_PEAK
4
Restituisce il numero massimo di oggetti USER.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è supportato fino a Windows 7 e Windows Server 2008 R2.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è il numero di handle per gli oggetti GUI in uso dal processo. Se non sono in uso oggetti GUI, il valore restituito è zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Un processo senza un'interfaccia utente grafica non usa risorse GUI, pertanto GetGuiResources restituirà zero.

Requisiti

   
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione winuser.h (include windows.h)
Libreria User32.lib
DLL User32.dll
Set di API ext-ms-win-ntuser-misc-l1-1-0 (introdotto in Windows 8)

Vedi anche

CreateProcess

GetCurrentProcess

OpenProcess

Funzioni di processi e thread