RasDialFunc

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

RasDialFunc函数是在RAS连接过程中发生状态更改时,RasDial函数调用的应用程序定义或库定义的回调函数。

VOID WINAPI RasDialFunc(

UINT 【unMsg】,//发生的事件类型
RASCONNSTATE 【rasconnstate】,//要输入的连接状态
DWORD 【dwError】//可能发生的错误
); 

参数

【unMsg】

指定发生的事件的类型。目前,唯一定义的事件是WM_RASDIALEVENT。

【rasconnstate】

指定RASCONNSTATE枚举器值,该值指示RasDial远程访问连接进程即将进入的状态。

【dwError】

表示发生的错误,如果没有发生错误,则为零。

RasDial呼叫RasDialFunc【dwError】在进入每个连接状态时设置为零。如果在一个状态内发生错误,RasDialFunc将再次调用非零【dwError】值。

返回值

没有。

备注

RasDialFunc回调函数的调用期间,RasDial连接操作被暂停。因此,您的RasDialFunc实施应通常尽可能快地返回。该规则有两个例外。异步(慢)设备如调制解调器通常具有以秒为单位而不是毫秒的时间间隔;来自RasDialFunc功能的不太及时的返回通常不是问题。当【dwError】非零时,提示返回要求也不适用,表示发生错误。例如,安装一个错误对话框并等待用户输入是安全的。

您的RasDialFunc实施不应取决于特定RASCONNSTATE连接状态的顺序或发生,因为这可能因平台而异。

不要在RasDialFunc回调函数内调用RasDial函数。您可以在回调函数内调用RasGetConnectStatusRasEnumEntriesRasEnumConnectionsRasGetErrorStringRasHangUp函数。例如,从回调函数内调用RasGetConnectStatus将有助于确定连接设备的名称和类型。

请注意,为方便起见,RasHangUp可以在RasDialFunc回调函数内调用。但是,在RasDialFunc回调函数返回后,大部分的挂起处理都会发生。

RasDialFunc是应用程序定义或库定义的函数名称的占位符。

也可以看看

RASCONNSTATE, RasDial, RasDialFunc1, RasDialFunc2, RasEnumConnections, RasEnumEntries, RasGetConnectStatus, RasGetErrorString, RasHangUp