Função GetGuiResources (winuser.h)

Recupera a contagem de identificadores para objetos de GUI (interface gráfica do usuário) em uso pelo processo especificado.

Sintaxe

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

Parâmetros

[in] hProcess

Um identificador para o processo. O identificador deve se referir a um processo na sessão atual e deve ter o direito de acesso PROCESS_QUERY_LIMITED_INFORMATION (consulte Processar direitos de segurança e acesso).

Se esse parâmetro for o valor especial GR_GLOBAL, o uso do recurso será relatado em todos os processos na sessão atual.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: O valor GR_GLOBAL não tem suporte até o Windows 7 e o Windows Server 2008 R2.

Windows Server 2003 e Windows XP: O identificador deve ter o direito de acesso PROCESS_QUERY_INFORMATION .

[in] uiFlags

O tipo de objeto gui. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
GR_GDIOBJECTS
0
Retornar a contagem de objetos GDI.
GR_GDIOBJECTS_PEAK
2
Retornar a contagem de pico de objetos GDI.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Esse valor não tem suporte até o Windows 7 e o Windows Server 2008 R2.

GR_USEROBJECTS
1
Retornar a contagem de objetos USER.
GR_USEROBJECTS_PEAK
4
Retornar a contagem de pico de objetos USER.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Esse valor não tem suporte até o Windows 7 e o Windows Server 2008 R2.

Retornar valor

Se a função for bem-sucedida, o valor retornado será a contagem de identificadores para objetos gui em uso pelo processo. Se nenhum objeto gui estiver em uso, o valor retornado será zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Um processo sem uma interface gráfica do usuário não usa recursos de GUI, portanto, GetGuiResources retornará zero.

Requisitos

   
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winuser.h (inclua windows.h)
Biblioteca User32.lib
DLL User32.dll
Conjunto de APIs ext-ms-win-ntuser-misc-l1-1-0 (introduzido no Windows 8)

Confira também

CreateProcess

GetCurrentProcess

Openprocess

Funções de thread e processo