Fonction MprAdminServerSetInfo (mprapi.h)

Article
03/04/2024

La fonction MprAdminServerSetInfo permet de définir le nombre de ports pour les appareils L2TP, PPTP et SSTP lorsque le service RRAS est en cours d’exécution.

Syntaxe

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

Paramètres

[in] hMprServer

Gérez le routeur à interroger. Obtenez ce handle en appelant MprAdminServerConnect.

[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 telles que définies 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_DDM_NOT_RUNNING	Le service RRAS ne s’exécute pas sur ce serveur.
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é.

Remarques

Cette fonction est utilisée pour définir le nombre de ports L2TP, PPTP et SSTP, et pour activer ou désactiver RRAS lorsque le service est en cours d’exécution. Ces valeurs sont persistantes, ce qui signifie que vous n’avez pas besoin de suivre cet appel avec un appel à MprConfigServerSetInfo. Notez que cette fonction étant asynchrone, vous risquez de ne pas voir l’impact des modifications immédiatement.

Exemples

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

Configuration requise

Condition requise	Valeur
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