Funzione MprConfigServerSetInfo (mprapi.h)

Articolo
08/24/2023

La funzione MprConfigServerSetInfo viene usata per impostare il numero di porte L2TP, PPTP e SSTP e abilitare o disabilitare RRAS nel Registro di sistema quando il servizio RRAS non è in esecuzione in modo che venga prelevato al successivo riavvio del sistema.

Sintassi

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

Parametri

[in] hMprServer

Gestire la configurazione del router. Ottenere questo handle chiamando MprConfigServerConnect.

[in] dwLevel

Valore DWORD che descrive il formato in cui le informazioni sono strutturate nel parametro lpbBuffer . I valori accettabili per dwLevel includono 1 e 2 come indicato nella tabella seguente.

Valore	Formato struttura
1	Windows Server 2003 o versione successiva: MPR_SERVER_1
2	Windows Server 2008 o versioni successive: MPR_SERVER_2

[in] lpbBuffer

Puntatore a un MPR_SERVER_1
o MPR_SERVER_2 struttura. Il parametro dwLevel indica il tipo di struttura.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Valore	Significato
ERROR_ACCESS_DENIED	L'applicazione chiamante non dispone di privilegi sufficienti.
ERROR_SUCCESS_REBOOT_REQUIRED	È necessario un riavvio del sistema per influire su tale modifica. Modificare il numero di porte usando la chiamata e il riavvio di MprConfigServerSetInfo .
ERROR_INVALID_PARAMETER	Se si tenta di impostare il numero di porte su più dei limiti supportati dal sistema, come definito negli argomenti MPR_SERVER_1 e MPR_SERVER_2 . Restituisce questo errore se si tenta di impostare il numero di porte PPTP su 0. Restituisce questo errore se i flag non sono validi o se lpbBuffer o hMprServer è NULL.
ERROR_NOT_SUPPORTED	Il valore di dwLevel non è valido.
ERROR_INVALID_HANDLE	l'handle hMprServer non è valido.
Altri	Usare FormatMessage per recuperare il messaggio di errore di sistema corrispondente al codice di errore restituito.

Commenti

Queste modifiche a una configurazione del server sono persistenti, ma non hanno alcun effetto su un server RRAS fino al riavvio.

Esempio

L'argomento Impostazione delle porte L2TP e PPTP di un servizio RRAS locale mostra questa funzione in uso.

Requisiti


Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mprapi.h
Libreria	Mprapi.lib
DLL	Mprapi.dll