Partager via


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
ERROR_ACCESS_DENIED
L’application appelante ne dispose pas de privilèges suffisants.
ERROR_INVALID_LEVEL
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.
ERROR_INVALID_HANDLE
La valeur hInterface n’est pas valide.
ERROR_INVALID_PARAMETER
Le paramètre lplpbBuffer est NULL.
ERROR_NOT_ENOUGH_MEMORY
Ressources insuffisantes pour terminer l’opération.
ERROR_NOT_SUPPORTED
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

MPR_INTERFACE_0

MPR_INTERFACE_1

MPR_INTERFACE_2

MPR_INTERFACE_3

MprAdminBufferFree

MprAdminInterfaceCreate

MprAdminServerConnect

Fonctions d’administration du routeur

Informations de référence sur la gestion des routeurs