Export (0) Print
Expand All
Expand Minimize

LockSetForegroundWindow function

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

Syntax


BOOL WINAPI LockSetForegroundWindow(
  _In_  UINT uLockCode
);

Parameters

uLockCode [in]

Type: UINT

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

ValueMeaning
LSFW_LOCK
1

Disables calls to SetForegroundWindow.

LSFW_UNLOCK
2

Enables calls to SetForegroundWindow.

 

Return value

Type:

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

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

See also

Reference
AllowSetForegroundWindow
SetForegroundWindow
Conceptual
Windows

 

 

Community Additions

ADD
Show:
© 2014 Microsoft