Freigeben über


MprAdminServerConnect-Funktion (mprapi.h)

Die Funktion MprAdminServerConnect stellt eine Verbindung mit einem Router zum Zweck der Verwaltung dieses Routers her. Rufen Sie diese Funktion auf, bevor Sie weitere Aufrufe des Servers tätigen. Verwenden Sie das in nachfolgenden Aufrufen zurückgegebene Handle, um Schnittstellen auf dem Server zu verwalten.

Syntax

DWORD MprAdminServerConnect(
  [in, optional] LPWSTR            lpwsServerName,
  [out]          MPR_SERVER_HANDLE *phMprServer
);

Parameter

[in, optional] lpwsServerName

Ein Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Namen des Remoteservers angibt. Wenn dieser Parameter NULL ist, gibt die Funktion ein Handle an den lokalen Computer zurück.

[out] phMprServer

Ein Zeiger auf eine HANDLE-Variable , die ein Handle an den Server empfängt. Verwenden Sie dieses Handle in nachfolgenden Aufrufen, um den Server zu verwalten.

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.
RPC_S_INVALID_BINDING
Diese Funktion wurde mit dem phMprServer-Parameter gleich NULL aufgerufen.
RPC_S_UNKNOWN_IF
Auf dem angegebenen Computer wird der Routing- und RAS-Dienst nicht ausgeführt.

Hinweise

MprAdminIsServiceRunning muss verwendet werden, um die status des RRAS-Diensts auf dem Remoteserver zu bestimmen. MprAdminServerConnect fragt den RRAS-Dienst beim Herstellen einer Verbindung nicht ab.

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

MprAdminServerDisconnect

Routerverwaltungsfunktionen

Referenz zur Routerverwaltung