LockSetForegroundWindow function (winuser.h)

The foreground process can call the LockSetForegroundWindow function to disable calls to the SetForegroundWindow function.

Syntax

BOOL LockSetForegroundWindow(
  [in] UINT uLockCode
);

Parameters

[in] uLockCode

Type: UINT

Specifies whether to enable or disable calls to SetForegroundWindow. This parameter can be one of the following values.

Value Meaning
LSFW_LOCK
1
Disables calls to SetForegroundWindow.
LSFW_UNLOCK
2
Enables calls to SetForegroundWindow.

Return value

Type: BOOL

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

The system automatically enables calls to SetForegroundWindow if the user presses the ALT key or takes some action that causes the system itself to change the foreground window (for example, clicking a background window).

This function is provided so applications can prevent other applications from making a foreground change that can interrupt its interaction with the user.

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-3 (introduced in Windows 10, version 10.0.10240)

See also

AllowSetForegroundWindow

Conceptual

Reference

SetForegroundWindow

Windows