LockSetForegroundWindow function (winuser.h)
The foreground process can call the LockSetForegroundWindow function to disable calls to the SetForegroundWindow function.
BOOL LockSetForegroundWindow(
[in] UINT uLockCode
);
[in] uLockCode
Type: UINT
Specifies whether to enable or disable calls to SetForegroundWindow. This parameter can be one of the following values.
| Value | Meaning |
|---|---|
|
Disables calls to SetForegroundWindow. |
|
Enables calls to SetForegroundWindow. |
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.
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.
| 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) |
Conceptual
Reference