Função AllowSetForegroundWindow (winuser.h)
Permite que o processo especificado defina a janela em primeiro plano usando a função SetForegroundWindow . O processo de chamada já deve ser capaz de definir a janela em primeiro plano. Para obter mais informações, consulte Comentários mais adiante neste tópico.
Sintaxe
BOOL AllowSetForegroundWindow(
[in] DWORD dwProcessId
);
Parâmetros
[in] dwProcessId
Tipo: DWORD
O identificador do processo que será habilitado para definir a janela em primeiro plano. Se esse parâmetro for ASFW_ANY, todos os processos serão habilitados para definir a janela em primeiro plano.
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. A função falhará se o processo de chamada não puder definir a janela em primeiro plano. Para obter informações de erro estendidas, chame GetLastError.
Comentários
O sistema restringe quais processos podem definir a janela em primeiro plano. Normalmente, um processo pode definir a janela em primeiro plano chamando a função SetForegroundWindow somente se:
- Todas as seguintes condições são verdadeiras:
- O processo de chamada pertence a um aplicativo da área de trabalho, não a um aplicativo UWP ou a um aplicativo da Windows Store projetado para Windows 8 ou 8.1.
- O processo em primeiro plano não desabilitou as chamadas para SetForegroundWindow por uma chamada anterior para a função LockSetForegroundWindow .
- O tempo limite de bloqueio em primeiro plano expirou (consulte SPI_GETFOREGROUNDLOCKTIMEOUT em SystemParametersInfo).
- Nenhum menu está ativo.
- Além disso, pelo menos uma das seguintes condições é verdadeira:
- O processo de chamada é o processo em primeiro plano.
- O processo de chamada foi iniciado pelo processo em primeiro plano.
- Atualmente, não há nenhuma janela em primeiro plano e, portanto, nenhum processo em primeiro plano.
- O processo de chamada recebeu o último evento de entrada.
- O processo em primeiro plano ou o processo de chamada está sendo depurado.
Um processo que pode definir a janela em primeiro plano pode habilitar outro processo para definir a janela em primeiro plano chamando AllowSetForegroundWindow. O processo especificado pelo parâmetro dwProcessId perde a capacidade de definir a janela em primeiro plano na próxima vez que o usuário gerar entrada, a menos que a entrada seja direcionada para esse processo ou na próxima vez que um processo chamar AllowSetForegroundWindow, a menos que o mesmo processo seja especificado como na chamada anterior para AllowSetForegroundWindow.
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-0 (introduzido no Windows 8) |
Confira também
Conceitual
Referência