通过

rasConnectionNotificationA 函数 (ras.h)

  • 项目

RasConnectionNotification 函数指定一个事件对象，当创建或终止 RAS 连接时，系统将该对象设置为信号状态。

语法

DWORD RasConnectionNotificationA(
  [in] HRASCONN unnamedParam1,
  [in] HANDLE   unnamedParam2,
  [in] DWORD    unnamedParam3
);

参数

[in] unnamedParam1

接收通知的 RAS 连接的句柄。 这可以是 RasDial 或 RasEnumConnections 函数返回的句柄。 如果 此参数INVALID_HANDLE_VALUE，则会收到本地客户端上所有 RAS 连接的通知。

[in] unnamedParam2

指定事件对象的句柄。 使用 CreateEvent 函数创建事件对象。

[in] unnamedParam3

指定 RAS 事件，该事件导致系统向 hEvent 参数指定的事件对象发出信号。 此参数是以下值的组合。

值 含义
RASCN_Connection
 如果INVALID_HANDLE_VALUE hrasconn，则会在创建任何 RAS 连接时向 hEvent 发出信号。
RASCN_Disconnection
 终止 hrasconn 连接时，将发出 hEvent 信号。 如果 hrasconn 是多链接连接，则会在所有子项断开连接时发出事件信号。 如果INVALID_HANDLE_VALUE hrasconn，则会在任何 RAS 连接终止时发出事件信号。
RASCN_BandwidthAdded
 Windows NT：如果 hrasconn 是组合多链接连接的句柄，则当连接子项时，将发出 hEvent 信号。
RASCN_BandwidthRemoved
 Windows NT：如果 hrasconn 是组合多链接连接的句柄，则当子项断开连接时，将发出 hEvent 信号。

返回值

如果函数成功，则返回值 ERROR_SUCCESS。

如果函数失败，则返回值为 路由和远程访问错误代码 或 Winerror.h 中的非零错误代码。

注解

若要确定何时向事件对象发出信号，请使用任何 等待函数。

发出事件信号时，请使用其他 RAS 函数（如 RasEnumConnections）获取有关已创建或终止的 RAS 连接的详细信息。

注意

ras.h 标头将 RasConnectionNotification 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

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

另请参阅

CreateEvent

RasEnumConnections

远程访问服务 (RAS) 概述

远程访问服务功能