Partager via


Fonction MprAdminServerSetInfo (mprapi.h)

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

Voir aussi

MPR_SERVER_1

MPR_SERVER_2

MprAdminBufferFree

MprAdminServerConnect

MprAdminServerGetInfo

Fonctions d’administration du routeur

Informations de référence sur la gestion des routeurs