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

请注意,为方便起见,可以从 RasDialFunc1 回调函数中调用 RasHangUp。 但是,大部分挂起处理发生在 RasDialFunc1 回调函数返回之后。

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

要求

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

另请参阅

RASCONNSTATE

RasDial

RasDialFunc

RasDialFunc2

RasEnumConnections

RasEnumEntries

RasGetConnectStatus

RasGetErrorString

RasHangUp

远程访问服务 (RAS) 概述

远程访问服务功能