MprAdminServerSetInfo-Funktion (mprapi.h)

Artikel
03/04/2024

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