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 CreateEventJ_ZBJV 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