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 |
|---|---|
|
Au moins un des éléments suivants est vrai :
|
|
Ressources insuffisantes pour terminer l’opération. |
|
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 |