Compartilhar via


Função LockSetForegroundWindow (winuser.h)

O processo em primeiro plano pode chamar a função LockSetForegroundWindow para desabilitar chamadas para a função SetForegroundWindow .

Sintaxe

BOOL LockSetForegroundWindow(
  [in] UINT uLockCode
);

Parâmetros

[in] uLockCode

Tipo: UINT

Especifica se é necessário habilitar ou desabilitar chamadas para SetForegroundWindow. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
LSFW_LOCK
1
Desabilita chamadas para SetForegroundWindow.
LSFW_UNLOCK
2
Habilita chamadas para SetForegroundWindow.

Retornar valor

Tipo: BOOL

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

O sistema habilita automaticamente as chamadas para SetForegroundWindow se o usuário pressionar a tecla ALT ou executar alguma ação que faça com que o próprio sistema altere a janela de primeiro plano (por exemplo, clicando em uma janela em segundo plano).

Essa função é fornecida para que os aplicativos possam impedir que outros aplicativos façam uma alteração em primeiro plano que possa interromper sua interação com o usuário.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winuser.h (inclua Windows.h)
Biblioteca User32.lib
DLL User32.dll
Conjunto de APIs ext-ms-win-ntuser-window-l1-1-3 (introduzido no Windows 10, versão 10.0.10240)

Confira também

AllowSetForegroundWindow

Conceitual

Referência

Setforegroundwindow

Windows