MprAdminDeregisterConnectionNotification function (mprapi.h)

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.

Syntax

DWORD MprAdminDeregisterConnectionNotification(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hEventNotification
);

Parameters

[in] hMprServer

Handle to the router on which to execute this call. Obtain this handle by calling MprAdminServerConnect.

[in] hEventNotification

Handle to an event object to deregister. This event is no longer signaled when an interface connects or disconnects.

Return value

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

Requirement Value
Minimum supported client None supported
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header mprapi.h
Library Mprapi.lib
DLL Mprapi.dll

See also

FormatMessage

MprAdminRegisterConnectionNotification

Router Administration Functions

Router Management Reference