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	Demand Dial Manager (DDM) が実行されていません。
ERROR_INVALID_PARAMETER	hEventNotification パラメーターが NULL であるか、無効なハンドルです。
その他	FormatMessage を使用して、返されたエラーコードに対応するシステムエラーメッセージを取得します。

イベントは、インターフェイスが接続または切断されたときに通知されます。イベントが通知されると、呼び出し元のアプリケーションは、MprAdminConnectionEnum や MprAdminInterfaceEnum などの関数を使用して、影響を受けるインターフェイスを特定できます。