MprAdminMIBEntryGetFirst, fonction (mprapi.h)

Article
02/29/2024

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

Syntaxe

DWORD MprAdminMIBEntryGetFirst(
  [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, des données pointées 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 première variable du jeu de variables exporté. Libérez cette mémoire en appelant MprAdminMIBBufferFree.

[out] lpOutEntrySize

Pointeur vers une variable DWORD . En cas de retour réussi, 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 transport/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