RASDIALFUNC2回调函数 (ras.h)
在远程访问连接过程中发生状态更改时, RasDialFunc2 回调函数由 RasDial 函数调用。 RasDialFunc2 函数类似于 RasDialFunc1 回调函数,只不过它提供多链接连接的其他信息。
语法
RASDIALFUNC2 Rasdialfunc2;
DWORD Rasdialfunc2(
ULONG_PTR unnamedParam1,
DWORD unnamedParam2,
HRASCONN unnamedParam3,
UINT unnamedParam4,
tagRASCONNSTATE unnamedParam5,
DWORD unnamedParam6,
DWORD unnamedParam7
)
{...}
参数
unnamedParam1
unnamedParam2
unnamedParam3
unnamedParam4
unnamedParam5
unnamedParam6
unnamedParam7
返回值
如果 RasDialFunc2 函数返回非零值, 则 RasDial 将继续发送回调通知。
如果 RasDialFunc2 函数返回零, 则 RasDial 将停止为所有子项发送回调通知。
注解
RasDial 连接操作在调用 RasDialFunc2 回调函数期间挂起。 因此, RasDialFunc2 实现通常会尽快返回。 该规则有两个例外。 异步 (慢) 设备(如调制解调器)的超时周期通常以秒而不是毫秒为单位; RasDialFunc2 函数返回缓慢通常不是问题。 当 dwError 为非零时,提示返回要求也不适用,指示已发生错误。 例如,可以安全地打开错误对话框并等待用户输入。
RasDialFunc2 实现不应依赖于特定 RASCONNSTATE 连接状态的顺序或发生情况,因为这可能因平台而异。
请勿从 RasDialFunc2 回调函数内部调用 RasDial 函数。 从回调函数中调用 RasGetConnectStatus、 RasEnumEntries、 RasEnumConnections、 RasGetErrorString 和 RasHangUp 函数。 例如,从回调函数内调用 RasGetConnectStatus 对于确定连接设备的名称和类型很有用。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | ras.h |