MprConfigServerSetInfo-Funktion (mprapi.h)

Artikel
08/24/2023

Die MprConfigServerSetInfo-Funktion wird verwendet, um die Portanzahl für L2TP-, PPTP- und SSTP-Ports festzulegen und RRAS in der Registrierung zu aktivieren oder zu deaktivieren, wenn der RRAS-Dienst nicht ausgeführt wird, sodass er beim nächsten Neustart des Systems aufgenommen wird.

Syntax

DWORD MprConfigServerSetInfo(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] DWORD             dwLevel,
  [in] LPBYTE            lpbBuffer
);

Parameter

[in] hMprServer

Handle für die Routerkonfiguration. Rufen Sie dieses Handle ab, indem Sie MprConfigServerConnect aufrufen.

[in] dwLevel

Ein DWORD-Wert, der das Format beschreibt, in dem die Informationen im lpbBuffer-Parameter strukturiert sind. Zulässige Werte für dwLevel sind 1 und 2, wie in der folgenden Tabelle aufgeführt.

Wert	Strukturformat
1	Windows Server 2003 oder höher: MPR_SERVER_1
2	Windows Server 2008 oder höher: MPR_SERVER_2

[in] lpbBuffer

Ein Zeiger auf eine MPR_SERVER_1
oder MPR_SERVER_2 Struktur. Der dwLevel-Parameter gibt den Typ der Struktur an.

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_SUCCESS_REBOOT_REQUIRED	Ein Systemneustart ist erforderlich, damit eine solche Änderung wirksam wird. Ändern Sie die Portanzahl mithilfe des MprConfigServerSetInfo-Aufrufs und neustarten.
ERROR_INVALID_PARAMETER	Wenn Sie versuchen, die Anzahl der Ports auf mehr als die vom System unterstützten Grenzwerte festzulegen, wie in den Themen MPR_SERVER_1 und MPR_SERVER_2 definiert. Gibt diesen Fehler zurück, wenn Sie versuchen, die Anzahl der PPTP-Ports auf 0 festzulegen. Gibt diesen Fehler zurück, wenn die Flags ungültig sind oder wenn lpbBuffer oder hMprServerNULL ist.
ERROR_NOT_SUPPORTED	Der Wert von dwLevel ist ungültig.
ERROR_INVALID_HANDLE	Das hMprServer-Handle ist ungültig.
Andere	Verwenden Sie FormatMessage , um die Systemfehlermeldung abzurufen, die dem zurückgegebenen Fehlercode entspricht.

Hinweise

Diese Änderungen an einer Serverkonfiguration sind persistent, haben jedoch keine Auswirkungen auf einen RRAS-Server, bis er neu gestartet wird.

Beispiele

Das Thema Festlegen von L2TP- und PPTP-Ports eines lokalen RRAS-Diensts zeigt, dass diese Funktion verwendet wird.

Anforderungen


Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mprapi.h
Bibliothek	Mprapi.lib
DLL	Mprapi.dll