Compartilhar via


Função WlxNegotiate (winwlx.h)

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

A função WlxNegotiate deve ser implementada por uma DLL GINA de substituição. Esta é a primeira chamada feita pelo Winlogon para a DLL gina. O WlxNegotiate permite que o GINA verifique se ele dá suporte à versão instalada do Winlogon.

Nota As DLLs GINA são ignoradas no Windows Vista.
 

Sintaxe

BOOL WlxNegotiate(
  [in]  DWORD  dwWinlogonVersion,
  [out] PDWORD pdwDllVersion
);

Parâmetros

[in] dwWinlogonVersion

Especifica qual versão do Winlogon se comunicará com o GINA.

[out] pdwDllVersion

Indica qual versão do Winlogon o GINA dá suporte. Essas informações de versão também são usadas pelo Winlogon para determinar qual tabela de expedição é passada para o GINA em chamadas subsequentes para WlxInitialize. Esta versão não pode ser maior do que a versão especificada por dwWinLogonVersion.

Retornar valor

Se a versão do Winlogon especificada por dwWinLogonVersion for maior ou igual à versão retornada em pdwDllVersion, a função retornará TRUE. Quando TRUE for retornado, o Winlogon continuará a ser inicializado.

Se dwWinLogonVersion for menor que pdwDllVersion, a função retornará FALSE. Quando FALSE for retornado, o Winlogon será encerrado e o sistema não será inicializado.

Comentários

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

WlxInitialize