Fonction MprAdminMIBEntryGetNext (mprapi.h)

Article
08/24/2023

La fonction MprAdminMIBEntryGetNext récupère la variable suivante d’un ensemble de variables exportées par un gestionnaire de protocole ou de routeur. Module qui traite l’appel suivant.

Syntaxe

DWORD MprAdminMIBEntryGetNext(
  [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. Ce handle est obtenu à partir d’un appel précédent à 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 traite 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 de 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 traite l’appel. La structure de données reçoit la valeur de la variable suivante à partir de l’ensemble de variables exporté. Libérez cette mémoire en appelant MprAdminMIBBufferFree.

[out] lpOutEntrySize

Pointeur vers une variable DWORD . Cette variable 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.

Notes

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

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