Función RasSecurityDialogEnd (rasshost.h)

La función RasSecurityDialogEnd es un punto de entrada de DLL de seguridad ras de terceros al que el servidor RAS llama para finalizar una transacción de autenticación.

Sintaxis

DWORD RasSecurityDialogEnd(
  [in] HPORT hPort
);

Parámetros

[in] hPort

Especifica el identificador de puerto que el servidor RAS pasó al archivo DLL de seguridad en la llamada RasSecurityDialogBegin para esta transacción de autenticación.

Valor devuelto

Si el archivo DLL de seguridad devuelve NO_ERROR, el servidor RAS no finaliza la transacción de autenticación. En este caso, el archivo DLL de seguridad debe llamar posteriormente a la función RasSecurityDialogComplete cuando esté listo para finalizar.

Si el archivo DLL de seguridad devuelve un código de error distinto de cero, el servidor RAS finaliza la transacción de autenticación. En este caso, el archivo DLL de seguridad no necesita realizar otra llamada RasSecurityDialogComplete . Devuelve un código de error definido en Winerror.h o Raserror.h, como ERROR_PORT_DISCONNECTED.

Comentarios

Cuando un archivo DLL de seguridad ha terminado de autenticar al usuario remoto, llama a la función RasSecurityDialogComplete . A continuación, el servidor RAS realiza una secuencia de limpieza que incluye una llamada a la función RasSecurityDialogEnd de la DLL. Esto proporciona a la DLL de seguridad una oportunidad para realizar cualquier limpieza necesaria. Para finalizar la transacción de autenticación, RasSecurityDialogEnd debe devolver un código de error distinto de cero.

El servidor RAS también puede llamar a RasSecurityDialogEnd si necesita finalizar anómalamente la transacción de autenticación antes de que el archivo DLL de seguridad llame a RasSecurityDialogComplete. En este caso, el archivo DLL de seguridad debe finalizar el subproceso de trabajo asociado al identificador de puerto hPort y realizar cualquier otra limpieza necesaria. Si RasSecurityDialogEnd devuelve un valor distinto de cero, el archivo DLL de seguridad no necesita llamar a RasSecurityDialogComplete.

Para la finalización normal y anómala, la función RasSecurityDialogEnd devuelve NO_ERROR para retrasar la finalización. Si lo hace, debe llamar posteriormente a RasSecurityDialogComplete cuando esté listo para finalizar.

Requisitos

Consulte también

Funciones de administración del servidor RAS

RasSecurityDialogBegin

RasSecurityDialogComplete

Información general sobre el servicio de acceso remoto (RAS)