Share via

Función GetGuiResources (winuser.h)

  • Artículo

Recupera el recuento de identificadores para objetos de interfaz gráfica de usuario (GUI) en uso por el proceso especificado.

Sintaxis

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

Parámetros

[in] hProcess

Identificador del proceso. El identificador debe hacer referencia a un proceso en la sesión actual y debe tener el derecho de acceso PROCESS_QUERY_LIMITED_INFORMATION (consulte Derechos de acceso y seguridad del proceso).

Si este parámetro es el valor especial GR_GLOBAL, el uso de recursos se notifica en todos los procesos de la sesión actual.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: El valor de GR_GLOBAL no se admite hasta Windows 7 y Windows Server 2008 R2.

Windows Server 2003 y Windows XP: El identificador debe tener el derecho de acceso PROCESS_QUERY_INFORMATION .

[in] uiFlags

Tipo de objeto de GUI. Este parámetro puede ser uno de los valores siguientes.

Valor Significado
GR_GDIOBJECTS
0
 Devuelve el recuento de objetos GDI.
GR_GDIOBJECTS_PEAK
2
 Devuelve el recuento máximo de objetos GDI.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: Este valor no se admite hasta Windows 7 y Windows Server 2008 R2.
GR_USEROBJECTS
1
 Devuelve el recuento de objetos USER.
GR_USEROBJECTS_PEAK
4
 Devuelve el número máximo de objetos USER.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: Este valor no se admite hasta Windows 7 y Windows Server 2008 R2.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es el recuento de identificadores de los objetos gui que usa el proceso. Si no hay objetos gui en uso, el valor devuelto es cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Un proceso sin una interfaz gráfica de usuario no usa recursos de GUI, por lo tanto, GetGuiResources devolverá cero.

Requisitos

   
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winuser.h (incluir windows.h)
Library User32.lib
Archivo DLL User32.dll
Conjunto de API ext-ms-win-ntuser-misc-l1-1-0 (introducido en Windows 8)

Consulte también

CreateProcess

GetCurrentProcess

OpenProcess

Funciones de proceso y subproceso