Función DwmRegisterThumbnail (dwmapi.h)

Artículo
08/23/2023

Crea una relación de miniatura del Administrador de ventanas de escritorio (DWM) entre las ventanas de destino y de origen.

Sintaxis

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

Parámetros

[in] hwndDestination

Identificador de la ventana que usará la miniatura de DWM. Establecer el identificador de la ventana de destino en cualquier otro tipo de ventana de nivel superior dará como resultado un valor devuelto de E_INVALIDARG.

[in] hwndSource

Identificador de la ventana que se va a usar como origen de miniaturas. Establecer el identificador de la ventana de origen en cualquier otro tipo de ventana de nivel superior dará como resultado un valor devuelto de E_INVALIDARG.

[out] phThumbnailId

Puntero a un identificador que, cuando esta función devuelve correctamente, representa el registro de la miniatura de DWM.

Valor devuelto

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

El registro de una relación de miniatura de DWM no modificará la composición del escritorio; para obtener información sobre el posicionamiento de miniaturas, consulte la documentación de la función DwmUpdateThumbnailProperties .

La ventana designada por hwndDestination debe ser la propia ventana de escritorio o ser propiedad del proceso que llama a DwmRegisterThumbnail. Esto es necesario para evitar que las aplicaciones afecten al contenido de otras aplicaciones.

El identificador de registro de miniaturas obtenido por esta función no es único globalmente, pero es único para el proceso. Llame a la función DwmUnregisterThumbnail para anular el registro de la miniatura. Esto debe hacerse dentro del proceso en el que se registró la relación.

Ejemplos

En el ejemplo siguiente se muestra cómo registrar la miniatura de escritorio.


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

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	dwmapi.h
Library	Dwmapi.lib
Archivo DLL	Dwmapi.dll