[New - Windows NT]
RasDialDlg功能尝试使用指定的电话簿条目和已登录用户的凭据建立RAS连接。该函数显示指示连接操作状态的对话框流。
BOOL RasDialDlg(
LPTSTR 【lpszPhonebook】, | //指向电话簿文件的完整路径和文件名 |
LPTSTR 【lpszEntry】, | //指向要拨打的电话簿条目的名称 |
LPTSTR 【lpszPhoneNumber】, | //指向要拨打的电话号码的指针 |
LPRASDIALDLG 【lpinfoit】 | //指向包含其他参数的结构的指针 |
); |
参数
【lpszPhonebook】
指向指定电话簿(.PBK)文件的完整路径和文件名的以空值终止的字符串的指针。如果此参数为NULL,则该函数使用当前的默认电话簿文件。默认电话簿文件是用户在拨号网络对话框的用户首选项属性表中选择的文件。
【lpszEntry】
指向以空字符结尾的字符串,其中包含要拨打的电话簿条目的名称。
【lpszPhoneNumber】
指向一个空值终止的字符串,其中包含覆盖电话簿条目中存储的号码的电话号码。如果此参数为NULL,则RasDialDlg将使用电话簿条目中的数字。
【lpinfoit】
指向包含其他输入和输出参数的RASDIALDLG结构的指针。在输入上,此结构的的dwSize成员必须指定的sizeof(RASDIALDLG)。如果发生错误,dwError成员返回错误代码;否则返回0。
返回值
如果函数建立RAS连接,则返回值为非零值。
如果发生错误,或者如果用户在拨号操作期间选择了取消按钮,则返回值为零。如果发生错误,RASDIALDLG结构的dwError成员返回非零系统或RAS错误代码。
备注
RasDialDlg功能显示与用户选择拨号按钮时主要拨号网络对话框显示的对话框类似的对话框。RasDialDlg功能对于要在不显示主电话簿对话框的情况下显示连接操作的标准用户界面的应用程序很有用。例如,RAS自动拨号服务使用此函数使用与远程地址相关联的电话簿条目建立连接。
RasDialDlg功能在连接操作期间显示对话框,以向用户提供关于操作进度的反馈。例如,对话框可能指示操作正在拨号,何时在远程服务器上验证用户的凭据,等等。对话框还提供一个取消按钮,供用户终止操作。
RasDialDlg建立连接或用户取消操作时返回。
也可以看看