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 函数。 从回调函数中调用 RasGetConnectStatusRasEnumEntriesRasEnumConnectionsRasGetErrorStringRasHangUp 函数。 例如,从回调函数内调用 RasGetConnectStatus 对于确定连接设备的名称和类型很有用。

注意为方便起见,可以从 RasDialFunc2 回调函数中调用 RasHangUp。 但是,大部分挂起处理发生在 RasDialFunc2 回调函数返回后。
 
注意RasDialFunc2 是应用程序定义的函数名称或库定义的函数名称的占位符。
 

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 ras.h

另请参阅

RASCONNSTATE

RasDial

RasDialFunc

RasDialFunc1

RasEnumConnections

RasEnumEntries

RasGetConnectStatus

RasGetErrorString

RasHangUp

远程访问服务 (RAS) 概述

远程访问服务功能