WlxActivateUserShell-Funktion (winwlx.h)

  • Artikel

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

Aktiviert das Benutzershellprogramm.

Die WlxActivateUserShell-Funktion muss von einer GINA-Ersatz-DLL implementiert werden. Winlogon ruft diese Funktion nach erfolgreicher Anmeldung auf, um von der GINA die Aktivierung des Shellprogramms des Benutzers anzufordern.

Hinweis GINA-DLLs werden in Windows Vista ignoriert.
 

Syntax

BOOL WlxActivateUserShell(
  [in] PVOID pWlxContext,
  [in] PWSTR pszDesktopName,
  [in] PWSTR pszMprLogonScript,
  [in] PVOID pEnvironment
);

Parameter

[in] pWlxContext

Ein Zeiger auf den GINA-Kontext, der dieser Fensterstation zugeordnet ist. Dies ist der Kontextwert, den die GINA zurückgibt, wenn Winlogon WlxInitialize für diese Station aufruft.

[in] pszDesktopName

Ein Zeiger auf eine mit NULL endende Breitzeichenzeichenfolge, die den Namen des Desktops angibt, auf dem die Shell gestartet wird. Übergeben Sie diese Zeichenfolge über das lpDesktop-Element der STARTUPINFO-Struktur an die CreateProcess- oder CreateProcessAsUser-Funktion.

[in] pszMprLogonScript

Ein Zeiger auf eine mit NULL endende Breitzeichenzeichenfolge, die alle Skriptnamen angibt, die von den Netzwerkanbieter-DLLs zurückgegeben werden. Netzwerkanbieter-DLLs können Skripts zurückgeben, die während der Anmeldung ausgeführt werden sollen. Die GINA kann sie jedoch ignorieren.

[in] pEnvironment

Gibt die anfänglichen Umgebungsvariablen für den Prozess an. Winlogon erstellt eine Kopie der Umgebung und übergibt sie an die GINA. Die GINA kann diese Umgebung ändern, bevor sie zum Initialisieren der Shell des Benutzers verwendet wird. Die GINA sollte die VirtualFree-Funktion aufrufen, um den für pEnvironment zugeordneten Arbeitsspeicher freizugeben.

Rückgabewert

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

Wenn die Funktion fehlschlägt, wird FALSE zurückgegeben. Wenn FALSE zurückgegeben wird, bricht Winlogon die Anmeldung ab.

Hinweise

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

Aktivieren Sie das Benutzershell-Programm immer in WlxActivateUserShell anstelle von WlxLoggedOutSAS. Dies gibt Winlogon die Möglichkeit, seinen Zustand zu aktualisieren, einschließlich des Festlegens von Arbeitsstations- und Desktopschutz, bevor angemeldete Benutzerprozesse ausgeführt werden dürfen.

Anforderungen

   
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

WlxLoggedOutSAS

WlxLogoff