Funzione WlxStartApplication (winwlx.h)

Articolo
03/13/2024

[La funzione WlxStartApplication non è più disponibile per l'uso a partire da Windows Server 2008 e Windows Vista.]

La funzione WlxStartApplication può essere implementata da una DLL GINA sostitutiva. Winlogon chiama questa funzione quando il sistema deve essere avviato da un'applicazione nel contesto dell'utente.

Esistono due motivi per cui il sistema potrebbe dover avviare un'applicazione nel contesto dell'utente:

Esplora risorse di Windows si è interrotto in modo imprevisto e deve essere riavviato.
Il gestore attività esteso deve essere eseguito.

Nota Le DLL GINA vengono ignorate in Windows Vista.

L'GINA può eseguire l'override di questo comportamento, se appropriato, usando la funzione WlxStartApplication .

Sintassi

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

Parametri

[in] pWlxContext

Puntatore al contesto GINA associato a questa stazione finestra. L'GINA restituisce questo valore di contesto quando Winlogon chiama WlxInitialize per questa stazione.

[in] pszDesktopName

Specifica il nome del desktop in cui avviare l'applicazione. Passare questa stringa alla funzione CreateProcess o CreateProcessAsUser tramite il membro lpDesktop della struttura STARTUPINFO.

[in] pEnvironment

Specifica l'ambiente iniziale per il processo. Winlogon crea questo ambiente e lo passa alla GINA. L'GINA può modificare questo ambiente prima di usarlo per inizializzare la shell dell'utente. Al termine dell'uso di questo ambiente, l'GINA deve liberare la memoria allocata per pEnvironment chiamando la funzione VirtualFree .

[in] pszCmdLine

Programma da eseguire.

Valore restituito

Se la funzione avvia correttamente l'applicazione, la funzione restituisce TRUE.

Se la funzione ha esito negativo o l'applicazione non è stata avviata, la funzione restituisce FALSE.

Commenti

Prima di chiamare WlxStartApplication, Winlogon imposta lo stato desktop in modo che il desktop corrente sia il desktop Winlogon e imposta lo stato della workstation in modo che il desktop sia bloccato.

Se la funzione WlxStartApplication non viene esportata dalla GINA, Winlogon eseguirà il processo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winwlx.h

Vedi anche

WlxInitialize

Condividi tramite