RasSecurityDialogSend

【勇芳软件工作室】汉化HomePreviousNext

[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