MprAdminMIBEntryGet, fonction (mprapi.h)

Article
02/29/2024

La fonction MprAdminMIBEntryGet récupère la valeur de l’une des variables exportées par un gestionnaire de routeur ou de protocole de routage.

Syntaxe

DWORD MprAdminMIBEntryGet(
  [in]  MIB_SERVER_HANDLE hMibServer,
  [in]  DWORD             dwProtocolId,
  [in]  DWORD             dwRoutingPid,
  [in]  LPVOID            lpInEntry,
  [in]  DWORD             dwInEntrySize,
  [out] LPVOID            *lplpOutEntry,
  [out] LPDWORD           lpOutEntrySize
);

Paramètres

[in] hMibServer

Gérez le routeur sur lequel exécuter cet appel. Obtenez ce handle en appelant MprAdminMIBServerConnect.

[in] dwProtocolId

Spécifie le gestionnaire de routeur qui a exporté la variable.

[in] dwRoutingPid

Spécifie le protocole de routage qui a exporté la variable.

[in] lpInEntry

Pointeur vers une structure de données opaque. Le format de la structure de données est déterminé par le module qui effectue la maintenance de l’appel. La structure de données doit contenir des informations qui spécifient la variable interrogée.

[in] dwInEntrySize

Spécifie la taille, en octets, de la structure de données pointée par lpInEntry.

[out] lplpOutEntry

Pointeur vers une variable pointeur. En cas de retour réussi, cette variable pointeur pointe vers une structure de données opaque. Le format de la structure de données est déterminé par le module qui effectue la maintenance de l’appel. La structure de données reçoit la valeur de la variable interrogée. Libérez cette mémoire en appelant MprAdminMIBBufferFree.

[out] lpOutEntrySize

Pointeur vers une variable DWORD qui, en cas de retour réussi, reçoit la taille en octets de la structure de données retournée par le biais du paramètre lplpOutEntry .

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’une des valeurs suivantes.

Valeur	Description
ERROR_ACCESS_DENIED	L’appelant ne dispose pas de privilèges suffisants.
ERROR_CANNOT_COMPLETE	La variable dwRoutingPid ne correspond à aucun protocole de routage installé.
ERROR_UNKNOWN_PROTOCOL_ID	La valeur dwTransportId ne correspond à aucun gestionnaire de routeur installé.
ERROR_NOT_ENOUGH_MEMORY	Ressources insuffisantes pour terminer l’opération.

Remarques

Ne passez pas null pour le paramètre lpInEntry , car le comportement résultant n’est pas défini.

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