Freigeben über


MprAdminServerSetInfo-Funktion (mprapi.h)

Die MprAdminServerSetInfo-Funktion wird verwendet, um die Anzahl der Ports für L2TP-, PPTP- und SSTP-Geräte festzulegen, wenn der RRAS-Dienst ausgeführt wird.

Syntax

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

Parameter

[in] hMprServer

Verarbeiten Sie den router, um abzufragen. Rufen Sie dieses Handle ab, indem Sie MprAdminServerConnect 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 umfassen 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 sich eine solche Änderung auswirkt. Ändern Sie die Portanzahl mithilfe des MprConfigServerSetInfo-Aufrufs , und starten Sie neu.
ERROR_INVALID_PARAMETER
Wenn Sie versuchen, die Anzahl der Ports auf mehr als die vom System unterstützten Grenzwerte festzulegen, die in den Themen MPR_SERVER_1 und MPR_SERVER_2 definiert sind.

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_DDM_NOT_RUNNING
Der RRAS-Dienst wird auf diesem Server nicht ausgeführt.
ERROR_NOT_SUPPORTED
Der Wert von dwLevel ist ungültig.
ERROR_INVALID_HANDLE
hMprServer-Handle ist ungültig.
Andere
Verwenden Sie FormatMessage , um die Systemfehlermeldung abzurufen, die dem zurückgegebenen Fehlercode entspricht.

Hinweise

Diese Funktion wird verwendet, um die Portanzahl für L2TP-, PPTP- und SSTP-Ports festzulegen und RRAS zu aktivieren oder zu deaktivieren, wenn der Dienst ausgeführt wird. Diese Werte sind persistent, was bedeutet, dass Sie diesem Aufruf nicht mit einem Aufruf von MprConfigServerSetInfo folgen müssen. Beachten Sie, dass diese Funktion asynchron ist, sodass Die Auswirkungen der Änderungen möglicherweise nicht sofort angezeigt werden.

Beispiele

Im Thema Festlegen von L2TP- und PPTP-Ports eines lokalen RRAS-Diensts wird diese Funktion verwendet.

Anforderungen

Anforderung Wert
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

MPR_SERVER_1

MPR_SERVER_2

MprAdminBufferFree

MprAdminServerConnect

MprAdminServerGetInfo

Routerverwaltungsfunktionen

Referenz zur Routerverwaltung