Fonction DwmRegisterThumbnail (dwmapi.h)

2024-02-28

Crée une relation de miniature du Gestionnaire de fenêtres de bureau (DWM) entre les fenêtres de destination et source.

Syntaxe

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

Paramètres

[in] hwndDestination

Handle de la fenêtre qui utilisera la miniature DWM. Si vous définissez le handle de la fenêtre de destination sur autre chose qu’un type de fenêtre de niveau supérieur, la valeur de retour est E_INVALIDARG.

[in] hwndSource

Handle de la fenêtre à utiliser comme source de miniatures. Si vous définissez le handle de fenêtre source sur autre chose qu’un type de fenêtre de niveau supérieur, la valeur de retour est E_INVALIDARG.

[out] phThumbnailId

Pointeur vers un handle qui, lorsque cette fonction est retournée avec succès, représente l’inscription de la miniature DWM.

Valeur retournée

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

L’inscription d’une relation de miniatureS DWM ne modifie pas la composition du bureau ; Pour plus d’informations sur le positionnement des miniatures, consultez la documentation relative à la fonction DwmUpdateThumbnailProperties .

La fenêtre désignée par hwndDestination doit être la fenêtre de bureau elle-même ou appartenir au processus qui appelle DwmRegisterThumbnail. Cela est nécessaire pour empêcher les applications d’affecter le contenu d’autres applications.

Le handle d’inscription de miniatures obtenu par cette fonction n’est pas globalement unique, mais est unique au processus. Appelez la fonction DwmUnregisterThumbnail pour annuler l’inscription de la miniature. Cette opération doit être effectuée dans le cadre du processus dans lequel la relation a été inscrite.

Exemples

L’exemple suivant montre comment inscrire la miniature du bureau.


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;	
}

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	dwmapi.h
Bibliothèque	Dwmapi.lib
DLL	Dwmapi.dll