SwitchToThisWindow function (winuser.h)

[This function is not intended for general use. It may be altered or unavailable in subsequent versions of Windows.]

Switches focus to the specified window and brings it to the foreground.

Syntax

void SwitchToThisWindow(
  [in] HWND hwnd,
  [in] BOOL fUnknown
);

Parameters

[in] hwnd

Type: HWND

A handle to the window.

[in] fUnknown

Type: BOOL

A TRUE for this parameter indicates that the window is being switched to using the Alt/Ctl+Tab key sequence. This parameter should be FALSE otherwise.

Return value

None

Remarks

This function is typically called to maintain window z-ordering.

This function was not included in the SDK headers and libraries until Windows XP with Service Pack 1 (SP1) and Windows Server 2003. If you do not have a header file and import library for this function, you can call the function using LoadLibrary and GetProcAddress.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header winuser.h (include Windows.h)
Library User32.lib
DLL User32.dll
API set ext-ms-win-ntuser-window-l1-1-4 (introduced in Windows 10, version 10.0.14393)

See also

Conceptual

IsWindowVisible

Reference

ShowWindow

Windows