DwmUnregisterThumbnail function

Removes a Desktop Window Manager (DWM) thumbnail relationship created by the DwmRegisterThumbnail function.

Syntax

DWMAPI DwmUnregisterThumbnail(
  HTHUMBNAIL hThumbnailId
);

Parameters

hThumbnailId

The handle to the thumbnail relationship to be removed. Null or non-existent handles will result in a return value of E_INVALIDARG.

Return Value

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

Unregistering DWM thumbnail relationships must be done within the process that registered the relationships.

Requirements

   
Windows version Windows Vista [desktop apps only] Windows Server 2008 [desktop apps only]
Target Platform Windows
Header dwmapi.h
Library Dwmapi.lib
DLL Dwmapi.dll

See Also

DWM Thumbnail Overview

Desktop Window Manager Overview

DwmQueryThumbnailSourceSize

DwmUpdateThumbnailProperties