AllowSetForegroundWindow, fonction (winuser.h)

Active le processus spécifié pour 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 Les 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’erreur étendues, 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 .
  • Aucun menu n’est actif.
• En outre, au moins l’une des conditions suivantes est remplie :
  • Le délai d’expiration du verrouillage de premier plan a expiré (voir SPI_GETFOREGROUNDLOCKTIMEOUT dans SystemParametersInfo).
  • Le processus appelant est le processus de premier plan.
  • Le processus appelant 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 débogué.

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.

Spécifications

Requirement	Valeur
Client minimum requis	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Fenêtres
Header	winuser.h (include Windows.h)
Library	User32.lib
DLL	User32.dll
Ensemble d’API	ext-ms-win-ntuser-window-l1-1-0 (introduit dans Windows 8)

Voir aussi

conceptuelle

LockSetForegroundWindow

Référence

SetForegroundWindow

Windows