ORASADFunc功能是一个应用程序定义的回调函数,可用于为自动拨号提供自定义用户界面。
提供此原型是为了与早期版本的Windows兼容。新应用程序应使用RASADFunc回调函数。在以后版本的RAS中可能会删除对该原型的支持。
BOOL WINAPI ORASADFunc(
HWND 【hwndOwner】, | //所有者窗口的句柄 |
LPSTR 【lpszEntry】, | //指向电话簿条目 |
DWORD 【dwFlags中】, | //保留;必须为零 |
LPDWORD 【lpdwRetCode】 | //接收拨号操作的结果 |
); |
参数
【hwndOwner】
处理所有者窗口。
【lpszEntry】
指向指定要使用的电话簿条目的以空值终止的字符串的指针。
【dwFlags中】
Reserved; must be zero.
【lpdwRetCode】
指向回调函数填充的变量与拨号操作的结果。如果拨号操作成功,将此变量设置为ERROR_SUCCESS。如果拨号操作失败,请将其设置为非零值。
返回值
如果回拨功能执行拨号操作,则返回TRUE。使用【lpdwRetCode】参数来指示拨号操作的结果。
如果回拨功能不执行拨号操作,请返回FALSE。在这种情况下,系统使用默认用户界面进行拨号。
备注
如果您的ORASADFunc功能执行拨号操作,它会显示自己的拨号用户界面,并拨打RasDial功能进行实际拨号。您的ORASADFunc然后返回TRUE,表示它接管了拨号。拨号操作完成后,将指定的变量设置为【lpdwRetCode】以指示成功或失败。
要为电话簿条目启用ORASADFunc处理程序,请在调用RasSetEntryProperties函数时使用RASENTRY结构。szAutodialDll成员指定包含处理程序的DLL的名称,szAutodialFunc成员指定处理程序的导出名称。
ORASADFunc函数是库定义函数名的占位符。ORASADFUNC类型是指向ORASADFunc函数的指针。
也可以看看