MprConfigInterfaceSetInfo, fonction (mprapi.h)
La fonction MprConfigInterfaceSetInfo définit la configuration de l’interface spécifiée.
Syntaxe
DWORD MprConfigInterfaceSetInfo(
[in] HANDLE hMprConfig,
[in] HANDLE hRouterInterface,
[in] DWORD dwLevel,
[in] LPBYTE lpbBuffer
);
Paramètres
[in] hMprConfig
Gérez la configuration du routeur. Obtenez ce handle en appelant MprConfigServerConnect.
[in] hRouterInterface
Handle vers la configuration de l’interface en cours de mise à jour. Obtenez ce handle en appelant MprConfigInterfaceCreate, MprConfigInterfaceGetHandle ou MprConfigInterfaceEnum.
[in] dwLevel
Valeur DWORD qui décrit le format dans lequel les informations sont structurées dans le paramètre lpBuffer . Les valeurs acceptables pour dwLevel sont 0, 1, 2 et 3, comme indiqué dans le tableau suivant.
Valeur | Structure Format |
---|---|
0 | MPR_INTERFACE_0 |
1 | MPR_INTERFACE_1 |
2 | MPR_INTERFACE_2 |
3 | Windows Server 2008 ou version ultérieure : MPR_INTERFACE_3 |
[in] lpbBuffer
Pointeur vers un
MPR_INTERFACE_0, MPR_INTERFACE_1,
MPR_INTERFACE_2 ou structure MPR_INTERFACE_3 . Le paramètre dwLevel indique le type de structure.
Les informations contenues dans cette structure sont utilisées pour mettre à jour la configuration de l’interface.
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 |
---|---|
|
Au moins un des éléments suivants est vrai :
|
|
L’interface qui correspond à hRouterInterface n’est pas présente dans la configuration du routeur. |
|
Utilisez FormatMessage pour récupérer le message d’erreur système qui correspond au code d’erreur retourné. |
Remarques
La fonction MprAdminInterfaceSetInfo prend en charge la structure MPR_INTERFACE_2 . Toutefois, MprConfigInterfaceSetInfo ne le fait pas. Pour apporter des modifications persistantes à une interface de numérotation à la demande, appelez MprAdminInterfaceSetInfo avec MPR_INTERFACE_2, puis appelez MprConfigInterfaceSetInfo avec MPR_INTERFACE_0 ou MPR_INTERFACE_1.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Aucun pris en charge |
Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
Plateforme cible | Windows |
En-tête | mprapi.h |
Bibliothèque | Mprapi.lib |
DLL | Mprapi.dll |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour