MprConfigInterfaceCreate, fonction (mprapi.h)

Article
08/24/2023

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