RasSecurityDialogSend 函数 (rasshost.h)

RasSecurityDialogSend 函数发送一条要显示在远程计算机上的终端窗口中的消息。 第三方 RAS 安全 DLL 发送此消息作为对远程用户的身份验证的一部分。

若要调用此函数，请先调用 LoadLibrary 函数以加载 Rasman.dll。 然后调用 GetProcAddress 函数以获取 DLL 的 RasSecurityDialogSend 入口点。

语法

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

参数

[in] hPort

指定 RAS 服务器在此身份验证事务的 RasSecurityDialogBegin 调用中传递给安全 DLL 的端口句柄。

[in] pBuffer

指向在调用 RasSecurityDialogBegin 时传递给安全 DLL 的发送缓冲区的指针。 在调用 RasSecurityDialogSend 之前，请将要发送给远程用户的消息复制到此缓冲区。 RasSecurityDialogBegin 函数的 SendBufSize 参数指示缓冲区可以存储的最大字节数。

[in] BufferLength

指定要在 pBuffer 缓冲区中发送的字节数。

返回值

如果函数成功，则返回值为 PENDING (raserror.h) 中定义。 这表示发送操作正在进行中。

如果发生错误，则返回值为 Raserror.h 或 Winerror.h 中定义的错误代码之一。 GetLastError 不提供扩展的错误信息。

注解

RasSecurityDialogSend 函数是异步的。 调用它以向远程用户发送消息后，调用 RasSecurityDialogReceive 函数，然后等待响应。 安全 DLL 可以进行任意数量的 RasSecurityDialogSend 调用，每次调用后跟 RasSecurityDialogReceive 调用。

当安全 DLL 对远程用户进行身份验证时，远程计算机上的连接操作将进入RASCS_Interactive暂停状态。 RasSecurityDialogSend 发送的消息在远程计算机上的终端窗口中显示为输出。 RasSecurityDialogReceive 收到的响应是远程用户在终端窗口中键入的输入。 RASCS_Interactive值在 RASCONNSTATE 枚举中定义。

要求

另请参阅

GetProcAddress

LoadLibrary

RAS 服务器管理功能

RASCONNSTATE

RasSecurityDialogBegin

RasSecurityDialogReceive

远程访问服务 (RAS) 概述