MprAdminInterfaceUpdatePhonebookInfo 函数 (mprapi.h)

MprAdminInterfaceUpdatePhonebookInfo 函数强制路由器拾取在指定的按需拨号接口上所做的更改。在对请求拨号接口的电话簿条目进行更改后调用此函数。

语法

DWORD MprAdminInterfaceUpdatePhonebookInfo(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hInterface
);

[in] hMprServer

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

[in] hInterface

请求拨号接口的句柄。通过调用 MprAdminInterfaceCreate 获取此句柄。

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

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

值	含义
ERROR_ACCESS_DENIED	调用应用程序没有足够的权限。
ERROR_CANNOT_LOAD_PHONEBOOK	函数无法将电话簿加载到内存中。
ERROR_CANNOT_OPEN_PHONEBOOK	函数找不到电话簿文件。
ERROR_DDM_NOT_RUNNING	(DDM) 的 Demand Dial Manager 未运行。
ERROR_INTERFACE_HAS_NO_DEVICES	当前没有设备与此接口关联。
ERROR_INVALID_HANDLE	hInterface 值无效。
ERROR_NOT_ENOUGH_MEMORY	资源不足，无法完成操作。
其他	使用 FormatMessage 检索与返回的错误代码对应的系统错误消息。