RASDIALFUNC1回调函数 (ras.h)
RasDialFunc1 函数在远程访问连接过程中发生状态更改时由 RasDial 函数调用。 RasDialFunc1 函数与 RasDialFunc 函数相当,但通过添加两个参数进行了增强:RAS 连接的句柄和扩展错误代码。
语法
RASDIALFUNC1 Rasdialfunc1;
void Rasdialfunc1(
HRASCONN unnamedParam1,
UINT unnamedParam2,
tagRASCONNSTATE unnamedParam3,
DWORD unnamedParam4,
DWORD unnamedParam5
)
{...}
参数
unnamedParam1
unnamedParam2
unnamedParam3
unnamedParam4
unnamedParam5
返回值
无
备注
RasDial 连接操作在调用 RasDialFunc1 回调函数期间挂起。 因此, RasDialFunc1 实现通常会尽快返回。 该规则有两个例外。 异步 (慢) 设备(如调制解调器)的超时周期通常以秒而不是毫秒为单位; RasDialFunc1 函数的缓慢返回通常不是问题。 当 dwError 为非零时,提示返回要求也不适用,指示已发生错误。 例如,可以安全地打开错误对话框并等待用户输入。
RasDialFunc1 实现不应依赖于特定 RASCONNSTATE 连接状态的顺序或发生情况,因为这可能因平台而异。
请勿从 RasDialFunc1 回调函数中调用 RasDial 函数。 从回调函数中调用 RasGetConnectStatus、 RasEnumEntries、 RasEnumConnections、 RasGetErrorString 和 RasHangUp 函数。 例如,从回调函数内调用 RasGetConnectStatus 对于确定连接设备的名称和类型很有用。
请注意,为方便起见,可以从 RasDialFunc1 回调函数中调用 RasHangUp。 但是,大部分挂起处理发生在 RasDialFunc1 回调函数返回之后。
RasDialFunc1 是应用程序定义的函数名称或库定义的函数名称的占位符。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | ras.h |