[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