Fonction MprAdminInterfaceTransportGetInfo (mprapi.h)

Article
08/24/2023

La fonction MprAdminInterfaceTransportGetInfo récupère des informations sur un transport en cours d’exécution sur une interface spécifiée.

Syntaxe

DWORD MprAdminInterfaceTransportGetInfo(
  [in]            MPR_SERVER_HANDLE hMprServer,
  [in]            HANDLE            hInterface,
  [in]            DWORD             dwTransportId,
  [out]           LPBYTE            *ppInterfaceInfo,
  [out, optional] LPDWORD           lpdwInterfaceInfoSize
);

Paramètres

[in] hMprServer

Gérez le routeur à partir duquel les informations sont récupérées. Obtenez ce handle en appelant MprAdminServerConnect.

[in] hInterface

Gérer l’interface. Ce handle est obtenu à partir d’un appel précédent à MprAdminInterfaceCreate.

[in] dwTransportId

Valeur DWORD qui décrit le transport pour lequel des informations sont demandées. Les valeurs acceptables pour dwTransportId sont répertoriées dans le tableau suivant.

Valeur	Transport (famille de protocoles)
PID_ATALK	Appletalk
PID_IP	Internet Protocol version 4
PID_IPX	Internet Packet Exchange
PID_NBF	Protocole d’images NetBIOS
PID_IPV6	Windows Server 2008 ou version ultérieure : Protocole Internet version 6

[out] ppInterfaceInfo

Pointeur vers une variable de pointeur. La variable pointeur pointe vers un en-tête d’informations qui reçoit des informations pour l’interface et le transport spécifiés. Utilisez les fonctions d’en-tête d’informations pour manipuler les en-têtes d’informations. Libérez cette mémoire en appelant MprAdminBufferFree.

[out, optional] lpdwInterfaceInfoSize

Pointeur vers une variable DWORD . Cette variable reçoit la taille en octets des informations d’interface retournées par le biais du paramètre ppInterfaceInfo .

Ce paramètre est facultatif. Si l’application appelante spécifie NULL pour ce paramètre, la fonction ne retourne pas la taille des informations d’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
ERROR_ACCESS_DENIED	L’application appelante ne dispose pas de privilèges suffisants.
ERROR_INVALID_HANDLE	La valeur hInterface n’est pas valide ou si l’interface spécifiée est désactivée administrativement.
ERROR_NO_SUCH_INTERFACE	Le transport spécifié ne s’exécute pas sur l’interface spécifiée.
ERROR_NOT_ENOUGH_MEMORY	Ressources insuffisantes pour terminer l’opération.
ERROR_UNKNOWN_PROTOCOL_ID	La valeur dwTransportId ne correspond à aucun transport pris en charge.

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

MprAdminInterfaceCreate

MprAdminInterfaceTransportSetInfo

MprAdminServerConnect

Fonctions d’administration du routeur

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

Partager via