Función MprAdminMIBEntryGet (mprapi.h)

Artículo
08/24/2023

La función MprAdminMIBEntryGet recupera el valor de una de las variables exportadas por un protocolo de enrutamiento o un administrador de enrutadores.

Sintaxis

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
);

Parámetros

[in] hMibServer

Controle al enrutador en el que se va a ejecutar esta llamada. Obtenga este identificador llamando a MprAdminMIBServerConnect.

[in] dwProtocolId

Especifica el administrador del enrutador que exportó la variable.

[in] dwRoutingPid

Especifica el protocolo de enrutamiento que exportó la variable.

[in] lpInEntry

Puntero a una estructura de datos opaca. El formato de la estructura de datos viene determinado por el módulo que atiende la llamada. La estructura de datos debe contener información que especifique la variable que se consulta.

[in] dwInEntrySize

Especifica el tamaño, en bytes, de la estructura de datos a la que apunta lpInEntry.

[out] lplpOutEntry

Puntero a una variable de puntero. Si la devolución es correcta, esta variable de puntero apunta a una estructura de datos opaca. El formato de la estructura de datos viene determinado por el módulo que atiende la llamada. La estructura de datos recibe el valor de la variable consultada. Libere esta memoria llamando a MprAdminMIBBufferFree.

[out] lpOutEntrySize

Puntero a una variable DWORD que, al devolverse correctamente, recibe el tamaño en bytes de la estructura de datos devuelta a través del parámetro lplpOutEntry .

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es NO_ERROR.

Si se produce un error en la función, el valor devuelto es uno de los valores siguientes.

Valor	Descripción
ERROR_ACCESS_DENIED	El autor de la llamada no tiene privilegios suficientes.
ERROR_CANNOT_COMPLETE	La variable dwRoutingPid no coincide con ningún protocolo de enrutamiento instalado.
ERROR_UNKNOWN_PROTOCOL_ID	El valor dwTransportId no coincide con ningún administrador de enrutadores instalado.
ERROR_NOT_ENOUGH_MEMORY	Recursos insuficientes para completar la operación.

Comentarios

No pase NULL para el parámetro lpInEntry porque el comportamiento resultante no está definido.

Requisitos

Requisito	Value
Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	mprapi.h
Library	Mprapi.lib
Archivo DLL	Mprapi.dll