MprAdminInterfaceGetInfo, fonction (mprapi.h)
La fonction MprAdminInterfaceGetInfo récupère des informations pour une interface spécifiée sur un serveur spécifié.
Syntaxe
DWORD MprAdminInterfaceGetInfo(
[in] MPR_SERVER_HANDLE hMprServer,
[in] HANDLE hInterface,
[in] DWORD dwLevel,
[in] LPBYTE *lplpbBuffer
);
Paramètres
[in] hMprServer
Gérez vers le routeur à interroger. Ce handle est obtenu à partir d’un appel précédent à MprAdminServerConnect.
[in] hInterface
Handle vers l’interface obtenue par un appel précédent à MprAdminInterfaceCreate.
[in] dwLevel
Valeur DWORD qui décrit le format dans lequel les informations sont structurées dans le paramètre lplpbBuffer . 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 |
Les valeurs 1, 2 et 3 sont valides uniquement pour les interfaces de type ROUTER_CONNECTION_STATE.
[in] lplpbBuffer
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.
Libérez cette mémoire en appelant MprAdminBufferFree.
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. |
|
La valeur dwLevel est 2, mais ce niveau n’est pas pris en charge pour l’interface. Par exemple, le type d’interface, tel que défini dans la structure MPR_INTERFACE_X, n’est pas IF_TYPE_FULL_ROUTER. |
|
La valeur hInterface n’est pas valide. |
|
Le paramètre lplpbBuffer est NULL. |
|
Ressources insuffisantes pour terminer l’opération. |
|
La valeur dwLevel n’est pas valide. |
Configuration requise
Condition requise | Valeur |
---|---|
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