Função RasSecurityDialogEnd (rasshost.h)
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.
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 |