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