ITaskbarList3::UnregisterTab method (shobjidl_core.h)

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

See also

ITaskbarList

ITaskbarList2

ITaskbarList3

ITaskbarList3::RegisterTab

ITaskbarList3::SetTabActive

ITaskbarList3::SetTabOrder

Taskbar Extensions