RasConnectionNotification

DWORD RasConnectionNotification(
  _In_ HRASCONN hrasconn,
  _In_ HANDLE   hEvent,
  _In_ DWORD    dwFlags
);

说明

该函数为RAS连接指派一个事件对象，当连接创建或终止时系统将此对象设置为signaled。

参数

hrasconn[in]

指定一个需要接收通知的连接句柄，可通过RasDial或RasEnumConnections函数获取该句柄。当该参数值为INVALID_HANDLE_VALUE时，将接收本机所有RAS连接的通知消息。

hEvent[in]

指定事件句柄。

dwFlags[in]

指定哪边原因会导致系统设置事件句柄signaled。该参数由以下值组合：

值	含义
RASCN_Connection	如果hrasconn值为 INVALID_HANDLE_VALUE，则任何RAS连接创建时都会收到通知
RASCN_Disconnection	当hrasconn指向的连接断开时事件对象被设置为signaled。如果hrasconn是一个multilink连接，那么当所有子连接断开时才会设置事件对象为signaled。如果hrasconn值为 INVALID_HANDLE_VALUE，则任何RAS连接终止时都会收到通知
RASCN_BandwidthAdded	Windows NT:如果hrasconn指向一个联合的multilink连接，当有一个子连接建立时事件对象被设置为signaled。
RASCN_BandwidthRemoved	Windows NT:如果hrasconn指向一个联合的multilink连接，当有一个子连接断开时事件对象被设置为signaled。

返回值

该函数成功时返回ERROR_SUCCESS。
否则返回一个非零值，可以在Routing and Remote Access Error Codes或winerror.h中找到定义。

系统支持

客户端最小支持	Windows 2000 专业版
服务端最小支持	Windows 2000 Server
Header	Ras.h
Library	Rasapi32.lib
DLL	Rasapi32.dll
Unicode和Ansi名称	RasConnectionNotificationW(Unicode) RasConnectionNotificationA(Ansi)