This topic has not yet been rated - Rate this topic

ITaskbarList3::UnregisterTab method

Applies to: desktop apps only

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

Syntax

Copy

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