RasConnectionNotification

[New - Windows NT]

The RasConnectionNotification function specifies an event object that the system sets to the signaled state when a RAS connection is created or terminated.

DWORD RasConnectionNotification(

HANDLE hEvent, // handle to an event object
DWORD dwFlags // type of event to receive notifications for
);  

Parameters

hEvent

Specifies the handle of an event object. Use the CreateEvent function to create an event object.

dwFlags

Indicates the RAS event that causes the system to signal the event object specified by the hEvent parameter. This parameter can be a combination of the following values.

Value Meaning
RASCN_Connection A new RAS connection has been created.
RASCN_Disconnection An existing RAS connection has been terminated.

Return Values

If the function succeeds, the return value is zero.

If the function fails, the return value is a nonzero error code.

Remarks

To determine when the event object is signaled, use any of the wait functions.

When the event is signaled, you can use other RAS functions, such as RasEnumConnections, to get more information about the RAS connection that was created or terminated.

See Also

CreateEvent, RasEnumConnections