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.
DWORD MprConfigServerSetInfo(
[in] MPR_SERVER_HANDLE hMprServer,
[in] DWORD dwLevel,
[in] LPBYTE lpbBuffer
);
[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.
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. |
|
Ein Systemneustart ist erforderlich, damit eine solche Änderung wirksam wird. Ändern Sie die Portanzahl mithilfe des MprConfigServerSetInfo-Aufrufs und neustarten. |
|
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. |
|
Der Wert von dwLevel ist ungültig. |
|
Das hMprServer-Handle ist ungültig. |
|
Verwenden Sie FormatMessage , um die Systemfehlermeldung abzurufen, die dem zurückgegebenen Fehlercode entspricht. |
Diese Änderungen an einer Serverkonfiguration sind persistent, haben jedoch keine Auswirkungen auf einen RRAS-Server, bis er neu gestartet wird.
Das Thema Festlegen von L2TP- und PPTP-Ports eines lokalen RRAS-Diensts zeigt, dass diese Funktion verwendet wird.
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 |