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) 未執行。
ERROR_INTERFACE_HAS_NO_DEVICES	目前沒有任何裝置與此介面相關聯。
ERROR_INVALID_HANDLE	hInterface值無效。
ERROR_NOT_ENOUGH_MEMORY	資源不足，無法完成作業。
其他	使用 FormatMessage 擷取對應至傳回之錯誤碼的系統錯誤訊息。