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.

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

Confira também

CreateProcess

GetCurrentProcess

Openprocess

Funções de thread e processo