Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
La fonction MprAdminInterfaceCreate crée une interface sur un serveur spécifié.
Syntaxe
DWORD MprAdminInterfaceCreate(
[in] MPR_SERVER_HANDLE hMprServer,
[in] DWORD dwLevel,
[in] LPBYTE lpbBuffer,
[out] HANDLE *phInterface
);
Paramètres
[in] hMprServer
Gérez le routeur sur lequel exécuter cet appel. Obtenez ce handle en appelant MprAdminServerConnect.
[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.
[out] phInterface
Pointeur vers une variable HANDLE . La variable reçoit un handle à utiliser dans tous les appels suivants pour gérer cette 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 |
|---|---|
|
L’application appelante ne dispose pas de privilèges suffisants. |
|
Le type d’interface de routeur n’est pas pris en charge, car Dynamic Interface Manager est configuré pour s’exécuter uniquement sur un réseau local. |
|
Une interface portant le même nom existe déjà. |
|
Ressources insuffisantes pour terminer l’opération. |
|
La valeur dwLevel n’est pas valide. |
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 |