Función MprAdminMIBEntryGetFirst (mprapi.h)

Artículo
08/24/2023

La función MprAdminMIBEntryGetFirst recupera la primera variable de algún conjunto de variables exportadas por un administrador de protocolos o enrutadores. El módulo que atiende la llamada define primero.

Sintaxis

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

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 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 los datos a los 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 primera variable del conjunto de variables exportadas. Libere esta memoria llamando a MprAdminMIBBufferFree.

[out] lpOutEntrySize

Puntero a una variable DWORD . Si la devolución se realiza correctamente, esta variable recibe el tamaño, en bytes, de la estructura de datos que se devolvió 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 transporte o enrutador 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