Función WlxStartApplication (winwlx.h)

[La función WlxStartApplication ya no está disponible para su uso a partir de Windows Server 2008 y Windows Vista.]

La función WlxStartApplication se puede implementar mediante un archivo DLL de GINA de reemplazo. Winlogon llama a esta función cuando el sistema necesita que se inicie una aplicación en el contexto del usuario.

Hay dos motivos por los que el sistema podría necesitar una aplicación para iniciarse en el contexto del usuario:

• El Explorador de Windows ha dejado de salir inesperadamente y debe reiniciarse.
• El administrador de tareas extendido debe ejecutarse.

Nota Los archivos DLL de GINA se omiten en Windows Vista.

 

GINA puede invalidar este comportamiento, si procede, mediante la función WlxStartApplication .

Sintaxis

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

Parámetros

[in] pWlxContext

Puntero al contexto de GINA asociado a esta estación de ventana. GINA devuelve este valor de contexto cuando Winlogon llama a WlxInitialize para esta estación.

[in] pszDesktopName

Especifica el nombre del escritorio en el que se va a iniciar la aplicación. Pase esta cadena a la función CreateProcess o CreateProcessAsUser a través del miembro lpDesktop de la estructura STARTUPINFO .

[in] pEnvironment

Especifica el entorno inicial del proceso. Winlogon crea este entorno y lo entrega a la GINA. GINA puede modificar este entorno antes de usarlo para inicializar el shell del usuario. Cuando GINA haya terminado de usar este entorno, debe liberar la memoria asignada para pEnvironment mediante una llamada a la función VirtualFree .

[in] pszCmdLine

Programa que se va a ejecutar.

Valor devuelto

Si la función inicia correctamente la aplicación, la función devuelve TRUE.

Si se produce un error en la función o la aplicación no se ha iniciado, la función devuelve FALSE.

Comentarios

Antes de llamar a WlxStartApplication, Winlogon establece el estado de escritorio para que el escritorio actual sea el escritorio de Winlogon y establezca el estado de la estación de trabajo para que el escritorio esté bloqueado.

Si la GINA no exporta la función WlxStartApplication , Winlogon ejecutará el proceso.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winwlx.h

Consulte también

WlxInitialize