MprAdminDeregisterConnectionNotification

The MprAdminDeregisterConnectionNotification function deregisters an event object that was previously registered using MprAdminRegisterConnectionNotification. Once deregistered, this event is no longer signaled when an interface connects or disconnects.

DWORD MprAdminDeregisterConnectionNotification(
  MPR_SERVER_HANDLE hMprServer,    // handle to server
  HANDLE hEventNotification        // handle to event
);

Parameters

hMprServer
[in] Handle to the Windows 2000 router on which to execute this call. Obtain this handle by calling MprAdminServerConnect.
hEventNotification
[in] Handle to an event object to deregister. This event will no longer be signaled when an interface connects or disconnects.

Return Values

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.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Header: Declared in Mprapi.h.
  Library: Use Mprapi.lib.

See Also

Router Management Reference, Router Administration Functions, FormatMessage, MprAdminRegisterConnectionNotification