The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

SwitchToThisWindow function

[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

C++


VOID WINAPI SwitchToThisWindow(
  _In_ HWND hWnd,
  _In_ BOOL fAltTab
);

Parameters

hWnd [in]

Type: HWND

A handle to the window.

fAltTab [in]

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

This function does not return a value.

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

Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Header	Winuser.h (include Windows.h)
Library	User32.lib
DLL	User32.dll