Función RasSecurityDialogSend (rasshost.h)

La función RasSecurityDialogSend envía un mensaje que se mostrará en una ventana de terminal en un equipo remoto. Un archivo DLL de seguridad ras de terceros envía este mensaje como parte de su autenticación de un usuario remoto.

Para llamar a esta función, primero llame a la función LoadLibrary para cargar Rasman.dll. A continuación, llame a la función GetProcAddress para obtener el punto de entrada RasSecurityDialogSend del archivo DLL.

Sintaxis

DWORD RasSecurityDialogSend(
  [in] HPORT hPort,
  [in] PBYTE pBuffer,
  [in] WORD  BufferLength
);

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.

[in] pBuffer

Puntero al búfer de envío que se pasó al archivo DLL de seguridad en la llamada a RasSecurityDialogBegin. Antes de llamar a RasSecurityDialogSend, copie en este búfer el mensaje que se enviará al usuario remoto. El parámetro SendBufSize de la función RasSecurityDialogBegin indica el número máximo de bytes que puede almacenar el búfer.

[in] BufferLength

Especifica el número de bytes que se van a enviar en el búfer de pBuffer .

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es PENDING (definido en Raserror.h). Esto indica que la operación de envío está en curso.

Si se produce un error, el valor devuelto es uno de los códigos de error definidos en Raserror.h o Winerror.h. GetLastError no proporciona información de error extendida.

Comentarios

La función RasSecurityDialogSend es asincrónica. Después de llamarlo para enviar un mensaje al usuario remoto, llame a la función RasSecurityDialogReceive y espere una respuesta. El archivo DLL de seguridad puede realizar cualquier número de llamadas RasSecurityDialogSend , con cada llamada seguida de una llamada RasSecurityDialogReceive .

Cuando un archivo DLL de seguridad autentica a un usuario remoto, la operación de conexión en el equipo remoto entra en un estado de RASCS_Interactive pausa. El mensaje enviado por RasSecurityDialogSend se muestra como salida en una ventana de terminal en el equipo remoto. La respuesta recibida por RasSecurityDialogReceive es la entrada que escribe el usuario remoto en la ventana del terminal. El valor RASCS_Interactive se define en la enumeración RASCONNSTATE .

Requisitos

Consulte también

GetProcAddress

LoadLibrary

Funciones de administración del servidor RAS

RASCONNSTATE

RasSecurityDialogBegin

RasSecurityDialogReceive

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