Compartilhar via


Função WlxStartApplication (winwlx.h)

[A função WlxStartApplication não está mais disponível para uso a partir do Windows Server 2008 e do Windows Vista.]

A função WlxStartApplication pode ser implementada por uma DLL GINA de substituição. O Winlogon chama essa função quando o sistema precisa que um aplicativo seja iniciado no contexto do usuário.

Há dois motivos pelos quais o sistema pode precisar de um aplicativo para iniciar no contexto do usuário:

  • O Windows Explorer foi encerrado inesperadamente e precisa ser reiniciado.
  • O gerenciador de tarefas estendido precisa ser executado.
Nota As DLLs GINA são ignoradas no Windows Vista.
 
A GINA pode substituir esse comportamento, se apropriado, usando a função WlxStartApplication .

Sintaxe

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

Parâmetros

[in] pWlxContext

Um ponteiro para o contexto GINA associado a esta estação de janela. O GINA retorna esse valor de contexto quando Winlogon chama WlxInitialize para esta estação.

[in] pszDesktopName

Especifica o nome da área de trabalho na qual iniciar o aplicativo. Passe essa cadeia de caracteres para a função CreateProcess ou CreateProcessAsUser por meio do membro lpDesktop da estrutura STARTUPINFO .

[in] pEnvironment

Especifica o ambiente inicial para o processo. O Winlogon cria esse ambiente e o entrega ao GINA. O GINA pode modificar esse ambiente antes de usá-lo para inicializar o shell do usuário. Quando o GINA terminar de usar esse ambiente, ele deverá liberar a memória alocada para pEnvironment chamando a função VirtualFree .

[in] pszCmdLine

O programa a ser executado.

Retornar valor

Se a função iniciar com êxito o aplicativo, a função retornará TRUE.

Se a função falhar ou o aplicativo não for iniciado, a função retornará FALSE.

Comentários

Antes de chamar WlxStartApplication, o Winlogon define o estado da área de trabalho para que a área de trabalho atual seja a área de trabalho do Winlogon e defina o estado da estação de trabalho para que a área de trabalho seja bloqueada.

Se a função WlxStartApplication não for exportada pelo GINA, o Winlogon executará o processo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winwlx.h

Confira também

WlxInitialize