GetGuiResources-Funktion (winuser.h)
Ruft die Anzahl der Handles für objekte der grafischen Benutzeroberfläche (GUI) ab, die vom angegebenen Prozess verwendet werden.
Syntax
DWORD GetGuiResources(
[in] HANDLE hProcess,
[in] DWORD uiFlags
);
Parameter
[in] hProcess
Ein Handle für den Prozess. Das Handle muss auf einen Prozess in der aktuellen Sitzung verweisen und über das PROCESS_QUERY_LIMITED_INFORMATION-Zugriffsrecht verfügen (siehe Verarbeiten von Sicherheit und Zugriffsrechten).
Wenn dieser Parameter der besondere Wert GR_GLOBAL ist, wird die Ressourcennutzung für alle Prozesse in der aktuellen Sitzung gemeldet.
Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Der GR_GLOBAL-Wert wird erst unter Windows 7 und Windows Server 2008 R2 unterstützt.
Windows Server 2003 und Windows XP: Das Handle muss über das Zugriffsrecht PROCESS_QUERY_INFORMATION verfügen.
[in] uiFlags
Der GUI-Objekttyp. Dieser Parameter kann einen der folgenden Werte annehmen.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert die Anzahl der Handles für GUI-Objekte, die vom Prozess verwendet werden. Wenn keine GUI-Objekte verwendet werden, ist der Rückgabewert null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Bemerkungen
Ein Prozess ohne grafische Benutzeroberfläche verwendet keine GUI-Ressourcen, daher gibt GetGuiResources null zurück.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winuser.h (windows.h einschließen) |
| Bibliothek | User32.lib |
| DLL | User32.dll |
| APIs | ext-ms-win-ntuser-misc-l1-1-0 (eingeführt in Windows 8) |