Función WlxInitialize (winwlx.h)

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

La función WlxInitialize debe implementarse mediante un archivo DLL de GINA de reemplazo. Winlogon llama a esta función una vez para cada estación de ventana presente en el equipo. Actualmente, el sistema operativo admite una estación de ventana por estación de trabajo.

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

 

El contexto devuelto por esta función se devolverá a la GINA en todas las llamadas posteriores.

Sintaxis

BOOL WlxInitialize(
  [in]  LPWSTR lpWinsta,
  [in]  HANDLE hWlx,
  [in]  PVOID  pvReserved,
  [in]  PVOID  pWinlogonFunctions,
  [out] PVOID  *pWlxContext
);

Parámetros

[in] lpWinsta

Puntero al nombre de la estación de ventana que se va a inicializar.

[in] hWlx

Identificador de Winlogon. La GINA debe proporcionar este identificador en todas las llamadas a las funciones de soporte técnico de Winlogon que implican esta estación de ventanas.

[in] pvReserved

Este parámetro está reservado para uso futuro y debe establecerse en NULL.

[in] pWinlogonFunctions

Puntero a una tabla de distribución de funciones compatible con Winlogon. El contenido de la tabla depende de la versión GINA DLL devuelta por la llamada a WlxNegotiate . Esta tabla no cambia, lo que permite que el archivo DLL de GINA haga referencia a la tabla sin copiarla. Si el archivo DLL de GINA necesita realizar una copia de la tabla, debe llamar a WlxGetOption y proporcionar WLX_OPTION_DISPATCH_TABLE_SIZE para el parámetro Option .

Valor	Significado
WLX_DISPATCH_VERSION_1_4	Tabla de distribución de Winlogon: versión 1.4
WLX_DISPATCH_VERSION_1_3	Tabla de distribución de Winlogon: versión 1.3
WLX_DISPATCH_VERSION_1_2	Tabla de distribución de Winlogon: versión 1.2
WLX_DISPATCH_VERSION_1_1	Tabla Winlogondispatch: versión 1.1
WLX_DISPATCH_VERSION_1_0	Tabla de distribución de Winlogon: versión 1.0

[out] pWlxContext

Puntero a un puntero a un void que contendrá la dirección del contexto de GINA para esta estación de ventana. Este contexto se pasa en todas las llamadas posteriores a la GINA desde Winlogon. El archivo DLL de GINA administra cualquier memoria usada por el contexto. El puntero de contexto se puede cambiar más adelante llamando a la función WlxSetOption con WLX_OPTION_CONTEXT_POINTER.

Valor devuelto

Si la función inicializa correctamente el archivo DLL de GINA, la función devuelve TRUE.

Si se produce un error en la función o si no se inicializó el archivo DLL de GINA, la función devuelve FALSE. Winlogon finalizará y el sistema no arrancará.

Comentarios

Se llama a WlxInitialize una vez para cada estación de ventana presente en el equipo.

Actualmente solo se admite una estación de ventana única denominada Winsta0.

Antes de llamar a WlxInitialize, 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.

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

WlxNegotiate