MprAdminMIBEntryGetNext

[This is preliminary documentation and subject to change.]

The MprAdminMIBEntryGetNext function retrieves the next variable of some set of variables exported by a protocol or router manager. It is up to the module servicing the call to define the semantics of next.

DWORD  MprAdminMIBEntryGetNext(
  MIB_SERVER_HANDLE hMibServer,    // handle to router
  DWORD dwTransportId,             // transport/router manager ID
  DWORD dwRoutingPid,              // routing protocol ID
  LPVOID lpInEntry,                // address of data to identify
                                   // variable.
  DWORD dwInEntrySize,             // size of data to identify
                                   // variable
  LPVOID * lplpOutEntry,           // address of output data
  LPDWORD lpdwOutEntrySize         // size of output data
);

Parameters

hMibServer

Handle to the Windows NT router on which to execute this call. This handle is obtained from a previous call to MprAdminMIBServerConnect.

dwTransportId

Identifies the router manager that exported the variable.

dwRoutingPid

Identifies the routing protocol that exported the variable.

lpInEntry

Pointer to an opaque data structure. The data structure's format is determined by the module servicing the call. The data structure should contain information to identify the variable being queried.

dwInEntrySize

Specifies the size, in bytes, of the data structure pointed to by lpInEntry.

lplpOutEntry

Pointer to a pointer variable. On successful return, this pointer variable will pointer to an opaque data structure. The data structure's format is determined by the module servicing the call. The data structure will contain the value of the next variable from the set of variables exported. Free this memory by calling MprAdminMIBBufferFree.

lpdwoutEntrySize

Pointer to a DWORD variable. On a successful return, this variable contains the size in bytes of the data structure returned through the lplpOutEntry parameter.

Return Values

NO_ERROR

The entry was retrieved successfully.

ERROR_ACCESS_DENIED

The caller does not have sufficient privilege.

ERROR_CANNOT_COMPLETE

The dwRoutingPid variable doesn't match any installed routing protocol.

ERROR_UNKNOWN_PROTOCOL_ID

The dwTransportId value does not match any installed router manager.

ERROR_NOT_ENOUGH_MEMORY

Insufficient resources to complete the operation.

Remarks

Do not pass in NULL for the lpInEntry parameter, as the resulting behavior is undefined.

See Also

MprAdminMIBBufferFree, MprAdminMIBServerConnect, MprAdminMIBEntryGet, MprAdminMIBEntryGetFirst, Protocol Identifiers, Transport Identifiers