Funzione RasSecurityDialogEnd (rasshost.h)

La funzione RasSecurityDialogEnd è un punto di ingresso dll di sicurezza RAS di terze parti che il server RAS chiama per terminare una transazione di autenticazione.

Nota Windows Server 2008, Windows Server 2003, Windows 2000 Server e Windows NT Server 4.0 forniscono attualmente il supporto dell'host di sicurezza RAS solo per i dispositivi seriali. Non sono supportati altri tipi di connessioni, ad esempio l'ISDN (Integrated Services Digital Network) o le connessioni VPN (Virtual Private Network).

 

Sintassi

DWORD RasSecurityDialogEnd(
  [in] HPORT hPort
);

Parametri

[in] hPort

Specifica l'handle di porta che il server RAS ha passato alla DLL di sicurezza nella chiamata RasSecurityDialogBegin per questa transazione di autenticazione.

Valore restituito

Se la DLL di sicurezza restituisce NO_ERROR, il server RAS non termina la transazione di autenticazione. In questo caso, la DLL di sicurezza deve successivamente chiamare la funzione RasSecurityDialogComplete quando è pronta per terminare.

Se la DLL di sicurezza restituisce un codice di errore diverso da zero, il server RAS termina la transazione di autenticazione. In questo caso, la DLL di sicurezza non deve eseguire un'altra chiamata RasSecurityDialogComplete . Restituisce un codice di errore definito in Winerror.h o Raserror.h, ad esempio ERROR_PORT_DISCONNECTED.

Commenti

Al termine dell'autenticazione dell'utente remoto, una DLL di sicurezza chiama la funzione RasSecurityDialogComplete . Il server RAS esegue quindi una sequenza di pulizia che include una chiamata alla funzione RasSecurityDialogEnd della DLL. In questo modo la DLL di sicurezza offre la possibilità di eseguire qualsiasi pulizia necessaria. Per terminare la transazione di autenticazione, RasSecurityDialogEnd deve restituire un codice di errore diverso da zero.

Il server RAS può anche chiamare RasSecurityDialogEnd se deve terminare in modo anomalo la transazione di autenticazione prima che la DLL di sicurezza chiami RasSecurityDialogComplete. In questo caso, la DLL di sicurezza deve terminare il thread di lavoro associato all'handle di porta hPort ed eseguire qualsiasi altra pulizia necessaria. Se RasSecurityDialogEnd restituisce un valore diverso da zero, la DLL di sicurezza non deve chiamare RasSecurityDialogComplete.

Per la terminazione normale e anomala, la funzione RasSecurityDialogEnd restituisce NO_ERROR per ritardare la terminazione. In questo caso, deve chiamare in un secondo momento RasSecurityDialogComplete quando è pronto per terminare.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	rasshost.h

Vedi anche

Funzioni di amministrazione del server RAS

RasSecurityDialogBegin

RasSecurityDialogComplete

Panoramica del servizio accesso remoto (RAS)