MprConfigInterfaceSetInfo, fonction (mprapi.h)

Article
03/04/2024

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