GetGuiResources, fonction (winuser.h)

Article
03/08/2023

Récupère le nombre de handles dans les objets d’interface utilisateur graphique (GUI) utilisés par le processus spécifié.

Syntaxe

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

Paramètres

[in] hProcess

Handle du processus. Le handle doit faire référence à un processus dans la session active et doit disposer du droit d’accès PROCESS_QUERY_LIMITED_INFORMATION (voir Traiter les droits de sécurité et d’accès).

Si ce paramètre est la valeur spéciale GR_GLOBAL, l’utilisation des ressources est signalée pour tous les processus de la session active.

Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP : La valeur GR_GLOBAL n’est pas prise en charge tant que Windows 7 et Windows Server 2008 R2.

Windows Server 2003 et Windows XP : Le handle doit disposer du droit d’accès PROCESS_QUERY_INFORMATION .

[in] uiFlags

Type d’objet GUI. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
GR_GDIOBJECTS 0	Retourne le nombre d’objets GDI.
GR_GDIOBJECTS_PEAK 2	Retourne le nombre maximal d’objets GDI. Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP : Cette valeur n’est pas prise en charge tant que Windows 7 et Windows Server 2008 R2.
GR_USEROBJECTS 1	Retourne le nombre d’objets USER.
GR_USEROBJECTS_PEAK 4	Retourne le nombre maximal d’objets USER. Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP : Cette valeur n’est pas prise en charge tant que Windows 7 et Windows Server 2008 R2.

Valeur retournée

Si la fonction réussit, la valeur de retour correspond au nombre de handles vers les objets GUI utilisés par le processus. Si aucun objet GUI n’est en cours d’utilisation, la valeur de retour est zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Notes

Un processus sans interface utilisateur graphique n’utilise pas de ressources d’interface graphique. Par conséquent, GetGuiResources retourne zéro.

Spécifications


Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure windows.h)
Bibliothèque	User32.lib
DLL	User32.dll
Ensemble d’API	ext-ms-win-ntuser-misc-l1-1-0 (introduit dans Windows 8)

Voir aussi

CreateProcess

GetCurrentProcess

OpenProcess

Fonctions de processus et de thread

Partager via