ITaskbarList3::UnregisterTab method (shobjidl_core.h)

Article
02/22/2024

Removes a thumbnail from an application's preview group when that tab or document is closed in the application.

Syntax

HRESULT UnregisterTab(
  [in] HWND hwndTab
);

Parameters

[in] hwndTab

Type: HWND

The handle of the tab window whose thumbnail is being removed. This is the same value with which the thumbnail was registered as part the group through ITaskbarList3::RegisterTab. This value is required and cannot be NULL.

Return value

Type: HRESULT

Returns S_OK if successful, or an error value otherwise. If hwndTab is NULL, this method returns an error.

Remarks

It is the responsibility of the calling application to free hwndTab through DestroyWindow. UnregisterTab must be called before the handle is freed.

Requirements

Requirement	Value
Minimum supported client	Windows 7 [desktop apps only]
Minimum supported server	Windows Server 2008 R2 [desktop apps only]
Target Platform	Windows
Header	shobjidl_core.h (include Shobjidl.h)
Library	Explorerframe.lib
DLL	Explorerframe.dll