Freigeben über


MprAdminInterfaceConnect-Funktion (mprapi.h)

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

Weitere Informationen

MprAdminInterfaceCreate

MprAdminInterfaceDisconnect

MprAdminInterfaceGetInfo

MprAdminServerConnect

Routerverwaltungsfunktionen

Referenz zur Routerverwaltung