PWLX_ASSIGN_SHELL_PROTECTION Rückruffunktion (winwlx.h)

Artikel
03/13/2024

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

Wird von GINA aufgerufen, um dem Shellprogramm eines neu angemeldeten Benutzers Schutz zuzuweisen.

Hinweis GINA-DLLs werden in Windows Vista ignoriert.

Der Shellprozess sollte in einem angehaltenen Zustand erstellt werden, dann sollte die WlxAssignShellProtection-Funktion aufgerufen werden, um den richtigen Schutz auf den Shellprozess anzuwenden.

Diese Funktion wurde durch die CreateProcessAsUser-Funktion der Windows-API ersetzt.

Syntax

PWLX_ASSIGN_SHELL_PROTECTION PwlxAssignShellProtection;

int PwlxAssignShellProtection(
  [in] HANDLE hWlx,
  [in] HANDLE hToken,
  [in] HANDLE hProcess,
  [in] HANDLE hThread
)
{...}

Parameter

[in] hWlx

Gibt das Winlogon-Handle an, das im WlxInitialize-Aufruf an GINA übergeben wird.

[in] hToken

Gibt das Handle für ein primäres Token an.

[in] hProcess

Gibt das Handle für den zu ändernden Prozess an. Der Prozess muss im angehaltenen Zustand erstellt werden, und dies sollte das in der PROCESS_INFORMATION-Struktur zurückgegebene Handle sein.

[in] hThread

Gibt das Handle für den anfänglichen Thread des Prozesses an.

Rückgabewert

Die WlxAssignShellProtection-Funktion gibt alle Fehler zurück, die beim Zuweisen von Schutz aufgetreten sind.

Hinweise

Die Windows-API CreateProcessAsUser-Funktion ersetzt WlxAssignShellProtection. Rufen Sie CreateProcessAsUser in WlxActivateUserShell auf, um den Shellprozess zu erstellen und seinen Schutz in einem einzelnen Aufruf festzulegen.

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

CreateProcessAsUser

WlxActivateUserShell

WlxInitialize

Freigeben über