[New - Windows NT]
RasSecurityDialogSend功能发送一条消息,显示在远程计算机的终端窗口中。第三方RAS安全性DLL作为远程用户验证的一部分发送此消息。
要调用此函数,必须先调用LoadLibrary函数来加载RASMAN.DLL。然后调用GetProcAddress函数来获取DLL的RasSecurityDialogSend入口点。
DWORD RasSecurityDialogSend
HPORT 【hPort】, | // RAS句柄到端口 |
PBYTE 【p缓冲器】, | //指向缓冲区的指针,其中包含要发送的数据 |
WORD 【BufferLength】 | //发送数据的大小(以字节为单位) |
); |
参数
【hPort】
指定RAS服务器在此验证事务的RasSecurityDialogBegin调用中传递给安全性DLL的端口句柄。
【p缓冲器】
指向在RasSecurityDialogBegin调用中传递给安全性DLL的发送缓冲区。在致电RasSecurityDialogSend之前,将此消息复制到远程用户。RasSecurityDialogBegin功能的【SendBufSize】参数表示可以复制到此缓冲区的最大字节数。
【BufferLength】
指定要在【p缓冲器】缓冲区中发送的字节数。
返回值
如果函数成功,则返回值为PENDING(在RASERROR.H中定义)。这表示发送操作正在进行中。
如果发生错误,则返回值是RASERROR.H或WINERROR.H中定义的错误代码之一。GetLastError不提供扩展错误信息。
备注
RasSecurityDialogSend功能是异步的。在呼叫它向远程用户发送消息后,调用RasSecurityDialogReceive功能,然后等待响应。安全DLL可以进行任何数量的RasSecurityDialogSend呼叫,每次呼叫后跟一个RasSecurityDialogReceive呼叫。
当安全性DLL验证远程用户时,远程计算机上的连接操作将进入RASCS_Interactive暂停状态。由RasSecurityDialogSend发送的消息在远程计算机的终端窗口中显示为输出。RasSecurityDialogReceive收到的响应是远程用户在终端窗口中键入的输入。RASCS_Interactive值在RASCONNSTATE枚举中定义。
也可以看看
GetProcAddress, LoadLibrary, RASCONNSTATE, RasSecurityDialogBegin, RasSecurityDialogReceive