MprConfigServerSetInfo, fonction (mprapi.h)

Article
08/24/2023

La fonction MprConfigServerSetInfo permet de définir le nombre de ports pour les ports L2TP, PPTP et SSTP et d’activer ou de désactiver RRAS sur ceux-ci dans le Registre lorsque le service RRAS n’est pas en cours d’exécution afin qu’il soit récupéré lors du prochain redémarrage du système.

Syntaxe

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

Paramètres

[in] hMprServer

Gérez la configuration du routeur. Obtenez ce handle en appelant MprConfigServerConnect.

[in] dwLevel

Valeur DWORD qui décrit le format dans lequel les informations sont structurées dans le paramètre lpbBuffer . Les valeurs acceptables pour dwLevel incluent 1 et 2, comme indiqué dans le tableau suivant.

Valeur	Structure Format
1	Windows Server 2003 ou version ultérieure : MPR_SERVER_1
2	Windows Server 2008 ou version ultérieure : MPR_SERVER_2

[in] lpbBuffer

Pointeur vers un MPR_SERVER_1
ou MPR_SERVER_2 structure. Le paramètre dwLevel indique le type de structure.

Valeur retournée

Si la fonction réussit, la valeur de retour est NO_ERROR.

Si la fonction échoue, la valeur de retour est l’un des codes d’erreur suivants.

Valeur	Signification
ERROR_ACCESS_DENIED	L’application appelante ne dispose pas de privilèges suffisants.
ERROR_SUCCESS_REBOOT_REQUIRED	Un redémarrage du système est nécessaire pour qu’une telle modification prenne effet. Modifiez le nombre de ports à l’aide de l’appel mprConfigServerSetInfo et du redémarrage.
ERROR_INVALID_PARAMETER	Si vous essayez de définir le nombre de ports sur plus que les limites prises en charge par le système, comme défini dans les rubriques MPR_SERVER_1 et MPR_SERVER_2 . Retourne cette erreur si vous essayez de définir le nombre de ports PPTP sur 0. Retourne cette erreur si les indicateurs ne sont pas valides ou si lpbBuffer ou hMprServer a la valeur NULL.
ERROR_NOT_SUPPORTED	La valeur de dwLevel n’est pas valide.
ERROR_INVALID_HANDLE	Le handle hMprServer n’est pas valide.
Autres	Utilisez FormatMessage pour récupérer le message d’erreur système qui correspond au code d’erreur retourné.

Notes

Ces modifications apportées à une configuration de serveur sont persistantes, mais n’ont aucun effet sur un serveur RRAS tant qu’il n’est pas redémarré.

Exemples

La rubrique Définition des ports L2TP et PPTP d’un service RRAS local montre cette fonction en cours d’utilisation.

Spécifications


Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	mprapi.h
Bibliothèque	Mprapi.lib
DLL	Mprapi.dll