Función MprAdminMIBEntryGetNext (mprapi.h)

Artículo
08/24/2023

La función MprAdminMIBEntryGetNext recupera la siguiente variable de algún conjunto de variables exportadas por un administrador de protocolos o enrutadores. El módulo que atiende la llamada define a continuación.

Sintaxis

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

Parámetros

[in] hMibServer

Controle al enrutador en el que se va a ejecutar esta llamada. Este identificador se obtiene de una llamada anterior a MprAdminMIBServerConnect.

[in] dwProtocolId

Especifica el administrador de enrutadores 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 especifica 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 se realiza correctamente, 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 siguiente del conjunto de variables exportadas. Libere esta memoria llamando a MprAdminMIBBufferFree.

[out] lpOutEntrySize

Puntero a una variable DWORD . Esta variable 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 ejecuta correctamente, el valor devuelto es NO_ERROR.

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

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


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