UnregisterTab
Collapse the table of content
Expand the table of content

ITaskbarList3::UnregisterTab method

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

hwndTab [in]

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

Minimum supported client

Windows 7 [desktop apps only]

Minimum supported server

Windows Server 2008 R2 [desktop apps only]

Header

Shobjidl.h

IDL

Shobjidl.idl

Library

Explorerframe.lib

DLL

Explorerframe.dll

See also

ITaskbarList
ITaskbarList2
ITaskbarList3
ITaskbarList3::RegisterTab
ITaskbarList3::SetTabActive
ITaskbarList3::SetTabOrder
Taskbar Extensions

 

 

Show:
© 2016 Microsoft