MprAdminRegisterConnectionNotification 函数 (mprapi.h)

MprAdminRegisterConnectionNotification 函数将事件对象注册到 Demand Dial Manager (DDM) 以便在接口连接或断开连接时发出事件信号。

语法

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

[in] hMprServer

要对其执行此调用的路由器的句柄。通过调用 MprAdminServerConnect 获取此句柄。

[in] hEventNotification

事件对象的句柄。每当接口连接或断开连接时，将发出此事件信号。

如果函数成功，则返回值NO_ERROR。

如果函数失败，则返回值为以下错误代码之一。

值	含义
ERROR_ACCESS_DENIED	调用应用程序没有足够的权限。
ERROR_DDM_NOT_RUNNING	DDM (DDM) 的 Demand Dial Manager 未运行。
ERROR_INVALID_PARAMETER	hEventNotification 参数为 NULL 或为无效句柄。
其他	使用 FormatMessage 检索与返回的错误代码对应的系统错误消息。

当接口连接或断开连接时，事件会发出信号。发出事件信号时，调用应用程序可以使用 MprAdminConnectionEnum 或 MprAdminInterfaceEnum 等函数来确定哪个接口受到影响。