GetGuiResources, fonction (winuser.h)
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 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) |