IShellBrowser::GetControlWindow method (shobjidl_core.h)

Article
04/02/2021

Gets the window handle to a browser control.

Syntax

HRESULT GetControlWindow(
  UINT id,
  HWND *phwnd
);

Parameters

id

Type: UINT

The control handle that is being requested. This parameter can be one of the following values:

FCW_TOOLBAR

Retrieves the window handle to the browser's toolbar.

FCW_STATUS

Retrieves the window handle to the browser's status bar.

FCW_TREE

Retrieves the window handle to the browser's tree view.

FCW_PROGRESS

Retrieves the window handle to the browser's progress bar.

phwnd

Type: HWND*

The address of the window handle to the Windows Explorer control.

Return value

Type: HRESULT

Returns S_OK if successful, or a COM-defined error value otherwise.

Remarks

GetControlWindow is used so views can directly manipulate the browser's controls. FCW_TREE should be used only to determine if the tree is present.

Notes to Calling Applications

GetControlWindow is used to manipulate and test the state of the control windows. Do not send messages directly to these controls; instead, use IShellBrowser::SendControlMsg. Be prepared for this method to return NULL. Later versions of Windows Explorer may not include a toolbar, status bar, or tree window.

Notes to Implementers

GetControlWindow returns the window handle to these controls if they exist in your implementation.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	shobjidl_core.h (include Shobjidl.h)
DLL	Shell32.dll (version 4.0 or later)