Auf Englisch lesen

Freigeben über


MprConfigServerSetInfo-Funktion (mprapi.h)

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

Weitere Informationen

FormatMessage

MPR_SERVER_0

MPR_SERVER_1

MPR_SERVER_2

MprConfigBufferFree

MprConfigServerConnect

MprConfigServerGetInfo

Routerkonfigurationsfunktionen

Referenz zur Routerverwaltung