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.
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 .
[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 |