Partager via

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
ERROR_INVALID_PARAMETER
 Au moins un des éléments suivants est vrai :
  • hMprConfig a la valeur NULL.
  • hRouterInterface a la valeur NULL.
  • dwLevel n’est pas 0, 1, 2 ou 3.
  • lpBuffer a la valeur NULL.
Retourne également ce code d’erreur si l’interface est de type ROUTER_IF_TYPE_DEDICATED ou ROUTER_IF_TYPE_INTERNAL et si l’interface est activée.
ERROR_NO_SUCH_INTERFACE
 L’interface qui correspond à hRouterInterface n’est pas présente dans la configuration du routeur.
Autres
 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

FormatMessage

MprConfigInterfaceCreate

MprConfigInterfaceEnum

MprConfigInterfaceGetHandle

MprConfigServerConnect

Fonctions de configuration du routeur

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

  • Last updated on