AllowSetForegroundWindow-Funktion (winuser.h)

Artikel
03/11/2023

Ermöglicht dem angegebenen Prozess, das Vordergrundfenster mithilfe der SetForegroundWindow-Funktion festzulegen. Der aufrufende Prozess muss bereits in der Lage sein, das Vordergrundfenster festzulegen. Weitere Informationen finden Sie unter Hinweise weiter unten in diesem Thema.

Syntax

BOOL AllowSetForegroundWindow(
  [in] DWORD dwProcessId
);

Parameter

[in] dwProcessId

Art: DWORD

Der Bezeichner des Prozesses, der zum Festlegen des Vordergrundfensters aktiviert wird. Wenn dieser Parameter ASFW_ANY ist, werden alle Prozesse aktiviert, um das Vordergrundfenster festzulegen.

Rückgabewert

Typ: BOOL

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Die Funktion schlägt fehl, wenn der aufrufende Prozess das Vordergrundfenster nicht festlegen kann. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Das System schränkt ein, welche Prozesse das Vordergrundfenster festlegen können. Normalerweise kann ein Prozess das Vordergrundfenster festlegen, indem er die SetForegroundWindow-Funktion nur aufruft , wenn:

Alle folgenden Bedingungen sind erfüllt:
- Der Aufrufprozess gehört zu einer Desktopanwendung, nicht zu einer UWP-App oder einer Windows Store-App, die für Windows 8 oder 8.1 entwickelt wurde.
- Der Vordergrundprozess hat Aufrufe von SetForegroundWindow durch einen vorherigen Aufruf der LockSetForegroundWindow-Funktion nicht deaktiviert.
- Das Timeout für die Vordergrundsperre ist abgelaufen (siehe SPI_GETFOREGROUNDLOCKTIMEOUT in SystemParametersInfo).
- Es sind keine Menüs aktiv.
Darüber hinaus gilt mindestens eine der folgenden Bedingungen:
- Der aufrufende Prozess ist der Vordergrundprozess.
- Der aufrufende Prozess wurde vom Vordergrundprozess gestartet.
- Es gibt derzeit kein Vordergrundfenster und somit keinen Vordergrundprozess.
- Der aufrufende Prozess hat das letzte Eingabeereignis empfangen.
- Entweder der Vordergrundprozess oder der aufrufende Prozess wird debuggt.

Ein Prozess, der das Vordergrundfenster festlegen kann, kann es einem anderen Prozess ermöglichen, das Vordergrundfenster festzulegen, indem AllowSetForegroundWindow aufgerufen wird. Der durch den dwProcessId-Parameter angegebene Prozess verliert die Fähigkeit, das Vordergrundfenster festzulegen, wenn der Benutzer das nächste Mal Eingaben generiert, es sei denn, die Eingabe wird an diesen Prozess gerichtet, oder wenn ein Prozess das nächste Mal AllowSetForegroundWindow aufruft, es sei denn, derselbe Prozess wurde wie im vorherigen Aufruf von AllowSetForegroundWindow angegeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-window-l1-1-0 (eingeführt in Windows 8)