Función RasSecurityDialogBegin (rasshost.h)
La función RasSecurityDialogBegin es un punto de entrada dll de seguridad ras de terceros al que el servidor RAS llama cuando un usuario remoto intenta conectarse. Esto permite que el archivo DLL de seguridad inicie su autenticación del usuario remoto.
Sintaxis
DWORD RasSecurityDialogBegin(
[in] HPORT hPort,
[in] PBYTE pSendBuf,
[in] DWORD SendBufSize,
[in] PBYTE pRecvBuf,
[in] DWORD RecvBufSize,
VOID(* )(SECURITY_MESSAGE *) RasSecurityDialogComplete
);
Parámetros
[in] hPort
Especifica un identificador de puerto RAS. El archivo DLL de seguridad usa este identificador en otras funciones de seguridad de RAS, como RasSecurityDialogSend y RasSecurityDialogReceive, para identificar esta transacción de autenticación.
Tenga en cuenta que este identificador solo es válido en las funciones de seguridad ras; no lo use en otras funciones de E/S.
[in] pSendBuf
Puntero a un búfer asignado por el servidor RAS. La DLL de seguridad usa este búfer con la función RasSecurityDialogSend para enviar texto que se muestra en la ventana del terminal RAS en el equipo remoto.
[in] SendBufSize
Especifica el tamaño, en bytes, del búfer pSendBuf .
[in] pRecvBuf
Puntero a un búfer asignado por el servidor RAS. El archivo DLL de seguridad usa este búfer con la función RasSecurityDialogReceive para recibir la respuesta del usuario remoto.
[in] RecvBufSize
Especifica el tamaño, en bytes, del búfer pRecvBuf .
RasSecurityDialogComplete
Valor devuelto
Si el archivo DLL de seguridad inicia correctamente la operación de autenticación, RasSecurityDialogBegin debe devolver NO_ERROR. En este caso, el archivo DLL de seguridad debe finalizar posteriormente la transacción de autenticación llamando a la función a la que apunta el parámetro RasSecurityDialogComplete .
Si se produce un error, RasSecurityDialogBegin debe devolver un código de error distinto de cero. En este caso, el servidor RAS bloquea la llamada y registra el error en el registro de eventos. Devolver un código de error distinto de cero finaliza la transacción de autenticación, por lo que el archivo DLL de seguridad no necesita llamar a la función RasSecurityDialogComplete .
Comentarios
Cuando un servidor RAS recibe una llamada desde un equipo remoto, llama a la función RasSecurityDialogBegin exportada por el archivo DLL de seguridad de RAS registrado, si existe. Cuando el servidor RAS llama a esta función, pasa la siguiente información al archivo DLL de seguridad:
- Identificador de puerto para identificar la conexión
- Punteros a búferes que se usarán al comunicarse con el usuario remoto
- Puntero a la función RasSecurityDialogComplete a la que se llamará cuando se haya completado la autenticación.
La implementación rasSecurityDialogBegin debe devolver lo antes posible, ya que el servidor RAS está bloqueado y no puede aceptar ninguna otra llamada hasta que RasSecurityDialogBegin devuelva. La función RasSecurityDialogBegin debe copiar los parámetros de entrada y crear un subproceso para comunicarse y autenticar al usuario remoto.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | rasshost.h |
Consulte también
Funciones de administración del servidor RAS
Información general sobre el servicio de acceso remoto (RAS)