DwmRegisterThumbnail 함수(dwmapi.h)

아티클
02/28/2024

대상 창과 원본 창 간에 DWM(데스크톱 창 관리자) 썸네일 관계를 만듭니다.

구문

HRESULT DwmRegisterThumbnail(
        HWND        hwndDestination,
        HWND        hwndSource,
  [out] PHTHUMBNAIL phThumbnailId
);

매개 변수

hwndDestination

DWM 축소판 그림을 사용할 창에 대한 핸들입니다. 대상 창 핸들을 최상위 창 유형 이외의 항목으로 설정하면 반환 값이 E_INVALIDARG.

hwndSource

썸네일 원본으로 사용할 창의 핸들입니다. 원본 창 핸들을 최상위 창 형식 이외의 항목으로 설정하면 반환 값이 E_INVALIDARG.

[out] phThumbnailId

이 함수가 성공적으로 반환될 때 DWM 미리 보기의 등록을 나타내는 핸들에 대한 포인터입니다.

반환 값

이 함수가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

DWM 미리 보기 관계를 등록해도 데스크톱 컴퍼지션이 수정되지 않습니다. 미리 보기 위치 지정에 대한 자세한 내용은 DwmUpdateThumbnailProperties 함수에 대한 설명서를 참조하세요.

hwndDestination으로 지정된 창은 데스크톱 창 자체이거나 DwmRegisterThumbnail을 호출하는 프로세스에서 소유해야 합니다. 이는 애플리케이션이 다른 애플리케이션의 콘텐츠에 영향을 주지 않도록 하는 데 필요합니다.

이 함수에서 가져온 썸네일 등록 핸들은 전역적으로 고유하지는 않지만 프로세스에 고유합니다. DwmUnregisterThumbnail 함수를 호출하여 미리 보기 등록을 취소합니다. 이 작업은 관계가 등록된 프로세스 내에서 수행해야 합니다.

예제

다음 예제에서는 데스크톱 썸네일을 등록하는 방법을 보여 줍니다.


HRESULT UpdateDesktop(HWND hwnd)
{
	HRESULT hr = S_OK;

	// Register the thumbnail
	HTHUMBNAIL thumbnail = NULL;

	hr = DwmRegisterThumbnail(hwnd, FindWindow(_T("Progman"), NULL), &thumbnail);
	if (SUCCEEDED(hr))
	{
		// Display the thumbnail using DwmUpdateThumbnailProperties
	}
	return hr;	
}

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	dwmapi.h
라이브러리	Dwmapi.lib
DLL	Dwmapi.dll