GetGuiResources-Funktion (winuser.h)

  • Artikel

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.

Wert Bedeutung
GR_GDIOBJECTS
0
 Gibt die Anzahl der GDI-Objekte zurück.
GR_GDIOBJECTS_PEAK
2
 Gibt die Spitzenanzahl von GDI-Objekten zurück.

Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Wert wird erst unter Windows 7 und Windows Server 2008 R2 unterstützt.
GR_USEROBJECTS
1
 Gibt die Anzahl der USER-Objekte zurück.
GR_USEROBJECTS_PEAK
4
 Gibt die Spitzenanzahl von USER-Objekten zurück.

Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Wert wird erst unter Windows 7 und Windows Server 2008 R2 unterstützt.

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)

Weitere Informationen

CreateProcess

GetCurrentProcess

OpenProcess

Prozess- und Threadfunktionen