Funzione MprAdminServerSetInfo (mprapi.h)

Articolo
02/29/2024

La funzione MprAdminServerSetInfo viene usata per impostare il numero di porte per i dispositivi L2TP, PPTP e SSTP quando il servizio RRAS è in esecuzione.

Sintassi

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

Parametri

[in] hMprServer

Gestire il router su cui eseguire una query. Ottenere questo handle chiamando MprAdminServerConnect.

[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_DDM_NOT_RUNNING	Il servizio RRAS non è in esecuzione in questo server.
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

Questa funzione viene usata per impostare il numero di porte per le porte L2TP, PPTP e SSTP e abilitare o disabilitare RRAS quando il servizio è in esecuzione. Questi valori sono persistenti, ovvero non è necessario seguire questa chiamata con una chiamata a MprConfigServerSetInfo. Si noti che questa funzione è asincrona, pertanto è possibile che non venga visualizzato immediatamente l'effetto delle modifiche.

Esempio

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

Requisiti

Requisito	Valore
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