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 |
|---|---|
|
Disables calls to SetForegroundWindow. |
|
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
Conceptual
Reference