Compartilhar via

Função RasSecurityDialogEnd (rasshost.h)

  • Artigo

A função RasSecurityDialogEnd é um ponto de entrada de DLL de segurança RAS de terceiros que o servidor RAS chama para encerrar uma transação de autenticação.

Nota No momento, o Windows Server 2008, o Windows Server 2003, o Windows 2000 Server e o Windows NT Server 4.0 fornecem suporte a host de segurança RAS somente para dispositivos seriais. Não há suporte para outros tipos de conexões, como ISDN (Rede Digital de Serviços Integrados) ou conexões VPN (rede virtual privada).
 

Sintaxe

DWORD RasSecurityDialogEnd(
  [in] HPORT hPort
);

Parâmetros

[in] hPort

Especifica o identificador de porta que o servidor RAS passou para a DLL de segurança na chamada RasSecurityDialogBegin para essa transação de autenticação.

Retornar valor

Se a DLL de segurança retornar NO_ERROR, o servidor RAS não encerrará a transação de autenticação. Nesse caso, a DLL de segurança deve chamar posteriormente a função RasSecurityDialogComplete quando estiver pronta para ser encerrada.

Se a DLL de segurança retornar um código de erro diferente de zero, o servidor RAS encerrará a transação de autenticação. Nesse caso, a DLL de segurança não precisa fazer outra chamada rasSecurityDialogComplete . Retornar um código de erro definido em Winerror.h ou Raserror.h, como ERROR_PORT_DISCONNECTED.

Comentários

Quando uma DLL de segurança terminar de autenticar o usuário remoto, ela chamará a função RasSecurityDialogComplete . Em seguida, o servidor RAS executa uma sequência de limpeza que inclui uma chamada para a função RasSecurityDialogEnd da DLL. Isso dá à DLL de segurança a oportunidade de executar qualquer limpeza necessária. Para encerrar a transação de autenticação, RasSecurityDialogEnd deve retornar um código de erro diferente de zero.

O servidor RAS também poderá chamar RasSecurityDialogEnd se precisar encerrar anormalmente a transação de autenticação antes que a DLL de segurança chame RasSecurityDialogComplete. Nesse caso, a DLL de segurança deve encerrar o thread de trabalho associado ao identificador de porta hPort e executar qualquer outra limpeza necessária. Se RasSecurityDialogEnd retornar um valor diferente de zero, a DLL de segurança não precisará chamar RasSecurityDialogComplete.

Para terminação normal e anormal, a função RasSecurityDialogEnd retorna NO_ERROR para atrasar a terminação. Se fizer isso, ele deverá chamar RasSecurityDialogComplete posteriormente quando estiver pronto para terminar.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho rasshost.h

Confira também

Funções de administração do servidor RAS

RasSecurityDialogBegin

RasSecurityDialogComplete

Visão geral do RAS (Serviço de Acesso Remoto)