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 |
|---|---|
|
Die aufrufende Anwendung verfügt nicht über ausreichende Berechtigungen. |
|
Diese Funktion wurde mit dem phMprServer-Parameter gleich NULL aufgerufen. |
|
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 |