The MprAdminRegisterConnectionNotification function registers an event object with the Demand Dial Manager (DDM) so that, if an interface connects or disconnects, the event is signaled.
DWORD MprAdminRegisterConnectionNotification( MPR_SERVER_HANDLE hMprServer, // handle to server HANDLE hEventNotification // handle to event );
If the function is successful, the return value is NO_ERROR.
If the function fails, the return value is one of the following error codes.
Value | Meaning |
---|---|
ERROR_ACCESS_DENIED | The calling application does not have sufficient privileges. |
ERROR_DDM_NOT_RUNNING | The Demand Dial Manager (DDM) is not running. |
ERROR_INVALID_PARAMETER | The hEventNotification parameter is NULL or is an invalid handle. |
Other | Use FormatMessage to retrieve the system error message that corresponds to the error code returned. |
The event is signaled when an interface connects or disconnects. When an event is signaled, the calling application can determine which interface is affected by using a function such as MprAdminConnectionEnum or MprAdminInterfaceEnum.
Windows NT/2000: Requires Windows 2000.
Header: Declared in Mprapi.h.
Library: Use Mprapi.lib.
Router Management Reference, Router Administration Functions, FormatMessage, MprAdminConnectionEnum, MprAdminDeregisterConnectionNotification, MprAdminInterfaceEnum