MprAdminRegisterConnectionNotification-Funktion (mprapi.h)

Artikel
02/29/2024

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
ERROR_ACCESS_DENIED	Die aufrufende Anwendung verfügt nicht über ausreichende Berechtigungen.
ERROR_DDM_NOT_RUNNING	Der DDM-Manager (Demand Dial Manager) wird nicht ausgeführt.
ERROR_INVALID_PARAMETER	Der hEventNotification-Parameter ist NULL oder ein ungültiges Handle.
Andere	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