[New - Windows NT]
RASADFunc功能是一个应用程序定义的回调函数,可用于为自动拨出提供自定义用户界面。
BOOL WINAPI RASADFunc(
LPTSTR 【lpszPhonebook】, | //指向电话簿文件的完整路径和文件名 |
LPTSTR 【lpszEntry】, | //指向要验证的条目名称的指针 |
LPRASADPARAMS 【lpAutodialParams】, | //指向RASADPARAMS结构的指针 |
LPDWORD 【lpdwRetCode】 | //接收拨号操作的结果 |
); |
参数
【lpszPhonebook】
Windows NT:指向指定电话簿(.PBK)文件的完整路径和文件名的以空值终止的字符串的指针。如果此参数为NULL,则该函数使用当前的默认电话簿文件。默认电话簿文件是用户在拨号网络对话框的用户首选项属性表中选择的文件。
【lpszEntry】
指向指定要使用的电话簿条目的以空值终止的字符串的指针。
【lpAutoDialParams】
指向RASADPARAMS结构的指针,指示如何定位AutoDial用户界面的窗口。结构也可以为自动拨号窗口指定父窗口。
【lpdwRetCode】
指向要在执行拨号操作时必须返回值的变量的指针。如果拨号操作成功,将此变量设置为ERROR_SUCCESS。如果拨号操作失败,请将其设置为非零值。
返回值
如果您的应用程序执行拨号操作,则返回TRUE。使用【lpdwRetCode】参数指示拨号操作的结果。
如果您的应用程序不执行拨号操作,请返回FALSE。在这种情况下,系统使用默认用户界面进行拨号。
备注
当系统启动具有自定义AutoDial处理程序的电话簿条目的自动拨号操作时,它会调用指定的RASADFunc.您的RASADFunc可以启动线程来执行自定义拨号操作。RASADFunc函数返回TRUE表示它接管拨号,或FALSE允许系统执行拨号。
如果您的RASADFunc功能执行拨号操作,它会显示自己的拨号用户界面,并调用RasDial功能进行实际拨号。您的RASADFunc然后返回TRUE,表示它接管了拨号。拨号操作完成后,设置【lpdwRetCode】参数指向的变量,表示成功或失败。
您的AutoDial DLL必须提供RASADFunc(ANSI)和RASADFUNCW(Unicode)版本的RASADFunc处理程序。要为电话簿条目启用RASADFunc自动拨号处理程序,请在调用RasSetEntryProperties函数时使用RASENTRY结构。szAutodialDll成员指定包含处理程序的DLL的名称,szAutodialFunc成员指定处理程序的导出名称。szAutodialFunc成员不应包含“A”或“W”后缀。
RASADFunc是图书馆定义的函数名称的占位符。RASADFUNC类型是指向RASADFunc函数的指针。
也可以看看