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) 未執行。
ERROR_INVALID_PARAMETER	hEventNotification 參數為 NULL 或無效的句柄。
其他	使用 FormatMessage 擷取對應至傳回之錯誤碼的系統錯誤訊息。

當介面連接或中斷連線時，事件會發出訊號。當事件收到訊號時，呼叫的應用程式可以使用 MprAdminConnectionEnum 或 MprAdminInterfaceEnum 之類的函式來判斷受影響的介面。