GetGuiResources 함수(winuser.h)

지정된 프로세스에서 사용 중인 GUI(그래픽 사용자 인터페이스) 개체에 대한 핸들 수를 검색합니다.

구문

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

[in] hProcess

프로세스에 대한 핸들입니다. 핸들은 현재 세션의 프로세스를 참조해야 하며 PROCESS_QUERY_LIMITED_INFORMATION 액세스 권한이 있어야 합니다( 프로세스 보안 및 액세스 권한 참조).

이 매개 변수가 GR_GLOBAL 특수 값인 경우 리소스 사용량은 현재 세션의 모든 프로세스에서 보고됩니다.

Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP:GR_GLOBAL 값은 Windows 7 및 Windows Server 2008 R2까지 지원되지 않습니다.

Windows Server 2003 및 Windows XP: 핸들에는 PROCESS_QUERY_INFORMATION 액세스 권한이 있어야 합니다.

[in] uiFlags

GUI 개체 형식입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
GR_GDIOBJECTS 0	GDI 개체 수를 반환합니다.
GR_GDIOBJECTS_PEAK 2	GDI 개체의 최대 개수를 반환합니다. Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: 이 값은 Windows 7 및 Windows Server 2008 R2까지 지원되지 않습니다.
GR_USEROBJECTS 1	USER 개체 수를 반환합니다.
GR_USEROBJECTS_PEAK 4	USER 개체의 최대 개수를 반환합니다. Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: 이 값은 Windows 7 및 Windows Server 2008 R2까지 지원되지 않습니다.

함수가 성공하면 반환 값은 프로세스에서 사용 중인 GUI 개체에 대한 핸들 수입니다. GUI 개체를 사용하지 않는 경우 반환 값은 0입니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

그래픽 사용자 인터페이스가 없는 프로세스는 GUI 리소스를 사용하지 않으므로 GetGuiResources 는 0을 반환합니다.


지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	winuser.h(windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll
API 세트	ext-ms-win-ntuser-misc-l1-1-0(Windows 8 도입)