AllowSetForegroundWindow, fonction (winuser.h)

  • Article

Permet au processus spécifié de définir la fenêtre de premier plan à l’aide de la fonction SetForegroundWindow . Le processus appelant doit déjà être en mesure de définir la fenêtre de premier plan. Pour plus d'informations, consultez la section Remarques plus loin dans cette rubrique.

Syntaxe

BOOL AllowSetForegroundWindow(
  [in] DWORD dwProcessId
);

Paramètres

[in] dwProcessId

Type : DWORD

Identificateur du processus qui sera activé pour définir la fenêtre de premier plan. Si ce paramètre est ASFW_ANY, tous les processus sont activés pour définir la fenêtre de premier plan.

Valeur retournée

Type : BOOL

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. La fonction échoue si le processus appelant ne peut pas définir la fenêtre de premier plan. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Le système restreint les processus qui peuvent définir la fenêtre de premier plan. Normalement, un processus peut définir la fenêtre de premier plan en appelant la fonction SetForegroundWindow uniquement si :

  • Toutes les conditions suivantes sont remplies :
    • Le processus d’appel appartient à une application de bureau, et non à une application UWP ou à une application du Windows Store conçue pour Windows 8 ou 8.1.
    • Le processus de premier plan n’a pas désactivé les appels à SetForegroundWindow par un appel précédent à la fonction LockSetForegroundWindow .
    • Le délai d’expiration du verrouillage de premier plan a expiré (voir SPI_GETFOREGROUNDLOCKTIMEOUT dans SystemParametersInfo).
    • Aucun menu n’est actif.
  • En outre, au moins l’une des conditions suivantes est remplie :
    • Le processus appelant est le processus de premier plan.
    • Le processus d’appel a été démarré par le processus de premier plan.
    • Il n’existe actuellement aucune fenêtre de premier plan et donc aucun processus de premier plan.
    • Le processus appelant a reçu le dernier événement d’entrée.
    • Le processus de premier plan ou le processus appelant est en cours de débogage.

Un processus qui peut définir la fenêtre de premier plan peut permettre à un autre processus de définir la fenêtre de premier plan en appelant AllowSetForegroundWindow. Le processus spécifié par le paramètre dwProcessId perd la possibilité de définir la fenêtre de premier plan la prochaine fois que l’utilisateur génère une entrée, sauf si l’entrée est dirigée vers ce processus, ou la prochaine fois qu’un processus appelle AllowSetForegroundWindow, sauf si le même processus est spécifié comme dans l’appel précédent à AllowSetForegroundWindow.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête winuser.h (inclure Windows.h)
Bibliothèque User32.lib
DLL User32.dll
Ensemble d’API ext-ms-win-ntuser-window-l1-1-0 (introduit dans Windows 8)

Voir aussi

Conceptuel

LockSetForegroundWindow

Référence

SetForegroundWindow

Windows