Partager via


MprAdminInterfaceQueryUpdateResult, fonction (mprapi.h)

La fonction MprAdminInterfaceQueryUpdateResult retourne le résultat de la dernière requête à un gestionnaire de routeur spécifié pour mettre à jour ses itinéraires pour une interface. Pour plus d’informations, consultez MprAdminInterfaceUpdateRoutes.

Syntaxe

DWORD MprAdminInterfaceQueryUpdateResult(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  HANDLE            hInterface,
  [in]  DWORD             dwProtocolId,
  [out] LPDWORD           lpdwUpdateResult
);

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

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

[in] dwProtocolId

Valeur DWORD qui spécifie quel gestionnaire de routeur est interrogé. Le routeur utilise un gestionnaire de routeur différent pour chaque protocole de transport. Les valeurs acceptables pour dwTransportId sont répertoriées dans le tableau suivant.

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

[out] lpdwUpdateResult

Pointeur vers une variable DWORD . Cette variable reçoit le résultat du dernier appel à MprAdminInterfaceUpdateRoutes.

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_INTERFACE_NOT_CONNECTED
L’interface spécifiée n’est pas connectée ; le résultat de la dernière mise à jour n’est plus disponible.
ERROR_INVALID_HANDLE
La valeur hInterface n’est pas valide.
ERROR_INVALID_PARAMETER
Le paramètre lpdwUpdateResult est NULL.
ERROR_NO_SUCH_INTERFACE
Le transport spécifié n’est pas en cours d’exécution sur l’interface spécifiée.
ERROR_UNKNOWN_PROTOCOL_ID
La valeur dwProtocolId ne correspond à aucun gestionnaire de routeur pris en charge.

Remarques

Le paramètre dwProtocolId spécifie à la fois un gestionnaire de transport et un gestionnaire de routeur, car le routeur gère un gestionnaire de routeur pour chaque transport.

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

MprAdminInterfaceCreate

MprAdminInterfaceUpdateRoutes

MprAdminServerConnect

Fonctions d’administration du routeur

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