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	Demand Dial Manager (DDM) が実行されていません。
ERROR_INTERFACE_HAS_NO_DEVICES	現在、このインターフェイスに関連付けられているデバイスはありません。
ERROR_INVALID_HANDLE	hInterface 値が無効です。
ERROR_NOT_ENOUGH_MEMORY	操作を完了するためのリソースが不足しています。
その他	FormatMessage を使用して、返されたエラーコードに対応するシステムエラーメッセージを取得します。