MprAdminInterfaceConnect-Funktion (mprapi.h)

Artikel
08/24/2023

Die Funktion MprAdminInterfaceConnect stellt eine Verbindung mit der angegebenen WAN-Schnittstelle her.

Syntax

DWORD MprAdminInterfaceConnect(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hInterface,
  [in] HANDLE            hEvent,
  [in] BOOL              fSynchronous
);

Parameter

[in] hMprServer

Verarbeiten Sie den Router, auf dem dieser Aufruf ausgeführt werden soll. Rufen Sie dieses Handle ab, indem Sie MprAdminServerConnect aufrufen.

[in] hInterface

Handle mit der Schnittstelle. Dieses Handle wird aus einem vorherigen Aufruf von MprAdminInterfaceCreate abgerufen.

[in] hEvent

Behandeln Sie ein Ereignis, das nach Abschluss des Verbindungsversuchs mit der Schnittstelle signalisiert wird. Die Funktion initiiert den Verbindungsversuch und gibt sofort zurück. Nachdem das Ereignis signalisiert wurde, können Sie das Ergebnis des Verbindungsversuchs abrufen, indem Sie MprAdminInterfaceGetInfo aufrufen.

Wenn dieser Parameter NULL ist und fBlockingtrue ist, ist dieser Aufruf synchron, d. h. die Funktion wird erst zurückgegeben, wenn der Verbindungsversuch abgeschlossen ist.

Die aufrufende Anwendung muss NULL für diesen Parameter angeben, wenn hMprServer einen Remoterouter angibt.

[in] fSynchronous

Wenn hEventNULL ist und dieser Parameter auf TRUE festgelegt ist, wird die Funktion erst zurückgegeben, wenn der Verbindungsversuch abgeschlossen ist.

Wenn hEventNULL ist und dieser Parameter auf FALSE festgelegt ist, wird die Funktion sofort zurückgegeben. Der Rückgabewert PENDING gibt an, dass der Verbindungsversuch erfolgreich gestartet wurde.

Wenn hEvent nicht NULL ist, wird dieser Parameter ignoriert.

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_ALREADY_CONNECTING	Für diese Schnittstelle wird bereits eine Verbindung hergestellt.
ERROR_DDM_NOT_RUNNING	Der DDM (Demand Dial Manager) wird nicht ausgeführt.
ERROR_INTERFACE_DISABLED	Die Schnittstelle ist derzeit deaktiviert.
ERROR_INTERFACE_HAS_NO_DEVICES	Für diese Schnittstelle sind keine Adapter verfügbar.
ERROR_INVALID_HANDLE	Der hInterface-Wert ist ungültig.
ERROR_SERVICE_IS_PAUSED	Der Bedarfswähldienst ist derzeit angehalten.
AUSSTEHENDE	Die Schnittstelle wird gerade hergestellt. Die aufrufende Anwendung muss auf das hEvent-Handle warten, wenn eins angegeben wurde. Nachdem das Ereignis signalisiert wurde, können Sie den Status der Verbindung und alle zugehörigen Fehler abrufen, indem Sie MprAdminInterfaceGetInfo aufrufen.

Hinweise

In der folgenden Tabelle ist die Beziehung zwischen hEvent und fBlocking zusammengefasst.

hEvent	fBlocking	Ergebnis
Ereignishandle	Wird ignoriert.	Der Aufruf gibt sofort eine Antwort zurück. Der Rückgabewert PENDING gibt an, dass der Versuch erfolgreich gestartet wurde. Warten Sie auf hEvent. Wenn hEvent signalisiert wird, verwenden Sie MprAdminInterfaceGetInfo , um den Erfolg oder Fehler des Verbindungsversuchs zu ermitteln.
NULL	TRUE	Der Aufruf wird erst zurückgegeben, wenn der Verbindungsversuch abgeschlossen ist.
NULL	FALSE	Der Aufruf gibt sofort eine Antwort zurück. Der Rückgabewert PENDING gibt an, dass der Versuch erfolgreich gestartet wurde.

Anforderungen


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