Partager via

MprConfigInterfaceCreate, fonction (mprapi.h)

La fonction MprConfigInterfaceCreate crée une interface de routeur dans la configuration de routeur spécifiée.

Syntaxe

DWORD MprConfigInterfaceCreate(
  [in]  HANDLE hMprConfig,
  [in]  DWORD  dwLevel,
  [in]  LPBYTE lpbBuffer,
  [out] HANDLE *phRouterInterface
);

Paramètres

[in] hMprConfig

Gérez la configuration du routeur. Obtenez ce handle en appelant MprConfigServerConnect.

[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 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.

[out] phRouterInterface

Pointeur vers une variable de handle. Cette variable reçoit un handle pour 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
  • dwLevel n’est pas 0, 1, 2 ou 3.
  • lpbBuffer a la valeur NULL
  • phRouterInterface a la valeur NULL
ERROR_NOT_ENOUGH_MEMORY
 Ressources insuffisantes pour terminer l’opération.
Autres
 Utilisez FormatMessage pour récupérer le message d’erreur système qui correspond au code d’erreur retourné.

Notes

La fonction MprAdminInterfaceCreate prend en charge la structure MPR_INTERFACE_2 . Toutefois, MprConfigInterfaceCreate ne le fait pas. Pour créer une interface de numérotation à la demande persistante après un redémarrage, appelez MprAdminInterfaceCreate avec MPR_INTERFACE_2, puis appelez MprConfigInterfaceCreate avec MPR_INTERFACE_0 ou MPR_INTERFACE_1.

Spécifications

   
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

MprConfigInterfaceDelete

MprConfigServerConnect

Fonctions de configuration du routeur

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

  • Last updated on