MprAdminRegisterConnectionNotification-Funktion (mprapi.h)
Die Funktion MprAdminRegisterConnectionNotification registriert ein Ereignisobjekt beim DDM (Demand Dial Manager), sodass das Ereignis signalisiert wird, wenn eine Schnittstelle eine Verbindung herstellt oder trennt.
Syntax
DWORD MprAdminRegisterConnectionNotification(
[in] MPR_SERVER_HANDLE hMprServer,
[in] HANDLE hEventNotification
);
Parameter
[in] hMprServer
Handle an den Router, auf dem dieser Aufruf ausgeführt werden soll. Rufen Sie dieses Handle ab, indem Sie MprAdminServerConnect aufrufen.
[in] hEventNotification
Handle für ein Ereignisobjekt. Dieses Ereignis wird immer dann signalisiert, wenn eine Schnittstelle eine Verbindung herstellt oder die Verbindung trennt.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.
Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.
Wert | Bedeutung |
---|---|
|
Die aufrufende Anwendung verfügt nicht über ausreichende Berechtigungen. |
|
Der DDM-Manager (Demand Dial Manager) wird nicht ausgeführt. |
|
Der hEventNotification-Parameter ist NULL oder ein ungültiges Handle. |
|
Verwenden Sie FormatMessage , um die Systemfehlermeldung abzurufen, die dem zurückgegebenen Fehlercode entspricht. |
Hinweise
Das Ereignis wird signalisiert, wenn eine Schnittstelle eine Verbindung herstellt oder die Verbindung trennt. Wenn ein Ereignis signalisiert wird, kann die aufrufende Anwendung mithilfe einer Funktion wie MprAdminConnectionEnum oder MprAdminInterfaceEnum ermitteln, welche Schnittstelle betroffen ist.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Nicht unterstützt |
Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | mprapi.h |
Bibliothek | Mprapi.lib |
DLL | Mprapi.dll |