WlxStartApplication-Funktion (winwlx.h)

Artikel
08/28/2023

[Die WlxStartApplication-Funktion ist ab Windows Server 2008 und Windows Vista nicht mehr verfügbar.]

Die WlxStartApplication-Funktion kann durch eine GINA-Ersatz-DLL implementiert werden. Winlogon ruft diese Funktion auf, wenn das System eine Anwendung im Kontext des Benutzers starten muss.

Es gibt zwei Gründe, warum das System möglicherweise eine Anwendung benötigt, um im Kontext des Benutzers zu starten:

Windows Explorer wurde unerwartet beendet und muss neu gestartet werden.
Der erweiterte Task-Manager muss ausgeführt werden.

Hinweis GINA-DLLs werden in Windows Vista ignoriert.

Die GINA kann dieses Verhalten ggf. mithilfe der WlxStartApplication-Funktion außer Kraft setzen.

Syntax

BOOL WlxStartApplication(
  [in] PVOID pWlxContext,
  [in] PWSTR pszDesktopName,
  [in] PVOID pEnvironment,
  [in] PWSTR pszCmdLine
);

Parameter

[in] pWlxContext

Ein Zeiger auf den GINA-Kontext, der dieser Fensterstation zugeordnet ist. Die GINA gibt diesen Kontextwert zurück, wenn Winlogon WlxInitialize für diese Station aufruft.

[in] pszDesktopName

Gibt den Namen des Desktops an, auf dem die Anwendung gestartet werden soll. Übergeben Sie diese Zeichenfolge über das lpDesktop-Element der STARTUPINFO-Struktur an die Funktion CreateProcess oder CreateProcessAsUser.

[in] pEnvironment

Gibt die anfängliche Umgebung für den Prozess an. Winlogon erstellt diese Umgebung und übergibt sie an die GINA. Die GINA kann diese Umgebung ändern, bevor sie zum Initialisieren der Shell des Benutzers verwendet wird. Wenn die GINA diese Umgebung verwendet hat, muss sie den für pEnvironment zugewiesenen Arbeitsspeicher durch Aufrufen der VirtualFree-Funktion freigeben.

[in] pszCmdLine

Das auszuführende Programm.

Rückgabewert

Wenn die Funktion die Anwendung erfolgreich startet, gibt die Funktion TRUE zurück.

Wenn die Funktion fehlschlägt oder die Anwendung nicht gestartet wurde, gibt die Funktion FALSE zurück.

Hinweise

Vor dem Aufrufen von WlxStartApplication legt Winlogon den Desktopstatus so fest, dass der aktuelle Desktop der Winlogon-Desktop ist, und legt den Arbeitsstationsstatus so fest, dass der Desktop gesperrt ist.

Wenn die WlxStartApplication-Funktion nicht von der GINA exportiert wird, führt Winlogon den Prozess aus.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winwlx.h

Weitere Informationen

WlxInitialize

Freigeben über