dwmRegisterThumbnail 函式 (dwmapi.h)
建立桌面視窗管理員 (DWM) 目的地與來源視窗之間的縮圖關聯性。
語法
HRESULT DwmRegisterThumbnail(
[in] HWND hwndDestination,
[in] HWND hwndSource,
[out] PHTHUMBNAIL phThumbnailId
);
參數
[in] hwndDestination
將使用 DWM 縮圖之視窗的句柄。 將目的地視窗句柄設定為最上層窗口類型以外的任何專案，將會導致傳回值E_INVALIDARG。
[in] 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 |