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