MprAdminInterfaceCreate, fonction (mprapi.h)
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 |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour