Função WlxInitialize (winwlx.h)

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

A função WlxInitialize deve ser implementada por uma DLL GINA de substituição. O Winlogon chama essa função uma vez para cada estação de janela presente no computador. Atualmente, o sistema operacional dá suporte a uma estação de janela por estação de trabalho.

Nota As DLLs GINA são ignoradas no Windows Vista.
 
O contexto retornado por essa função será passado de volta para o GINA em todas as chamadas subsequentes.

Sintaxe

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

Parâmetros

[in] lpWinsta

Um ponteiro para o nome da estação de janela que está sendo inicializada.

[in] hWlx

Um identificador para Winlogon. A GINA deve fornecer esse identificador em todas as chamadas para funções de suporte do Winlogon que envolvem essa estação de janela.

[in] pvReserved

Esse parâmetro é reservado para uso futuro e deve ser definido como NULL.

[in] pWinlogonFunctions

Um ponteiro para uma tabela de expedição de função de suporte do Winlogon. O conteúdo da tabela depende da versão DLL gina retornada pela chamada WlxNegotiate . Essa tabela não é alterada, o que permite que a DLL GINA faça referência à tabela sem copiá-la. Se a DLL gina precisar fazer uma cópia da tabela, ela deverá chamar WlxGetOption e fornecer WLX_OPTION_DISPATCH_TABLE_SIZE para o parâmetro Option .

Valor Significado
WLX_DISPATCH_VERSION_1_4
Tabela de expedição do Winlogon – versão 1.4
WLX_DISPATCH_VERSION_1_3
Tabela de expedição do Winlogon – versão 1.3
WLX_DISPATCH_VERSION_1_2
Tabela de expedição do Winlogon – versão 1.2
WLX_DISPATCH_VERSION_1_1
Tabela Winlogondispatch – versão 1.1
WLX_DISPATCH_VERSION_1_0
Tabela de expedição do Winlogon – versão 1.0

[out] pWlxContext

Um ponteiro para um ponteiro para um VOID que conterá o endereço do contexto GINA desta estação de janela. Esse contexto é passado em todas as chamadas subsequentes para o GINA do Winlogon. A DLL gina gerencia qualquer memória usada pelo contexto. O ponteiro de contexto pode ser alterado posteriormente chamando a função WlxSetOption com WLX_OPTION_CONTEXT_POINTER.

Retornar valor

Se a função inicializar com êxito a DLL GINA, a função retornará TRUE.

Se a função falhar ou se a DLL GINA não tiver sido inicializada, a função retornará FALSE. O Winlogon será encerrado e o sistema não será inicializado.

Comentários

WlxInitialize é chamado uma vez para cada estação de janela presente no computador.

Atualmente, há suporte para apenas uma única estação de janela chamada Winsta0.

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

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

WlxNegotiate