Share via


MIBEntryGetFirst callback function

The routing protocol calls MIBEntryGetFirst to execute a Get First request of the router manager or a peer protocol DLL. Implement this function to handle SNMP-style requests.

Syntax

DWORD CALLBACK MIBEntryGetFirst(
  _In_    DWORD dwRoutingPid,
  _In_    DWORD InputDataSize,
  _In_    PVOID InputData,
  _Inout_ DWORD *OutputDataSize,
  _Out_   PVOID OutputData
);

Parameters

  • dwRoutingPid [in]
    Specifies the identifier of the DLL that should process this request. This parameter can be the identifier of the router manager or the identifier of a routing protocol.

  • InputDataSize [in]
    Specifies the size, in bytes, of the data to pass with the Get First request.

  • InputData [in]
    Pointer to the data to pass with the Get First request.

  • OutputDataSize [in, out]
    A pointer to a DWORD variable:

    On input, this variable specifies the size, in bytes, of the output buffer.

    On output, this variable receives the size, in bytes, of the data placed in the output buffer. If the initial size is not large enough, this variable contains the buffer size required to hold all of the output data.

  • OutputData [out]
    Pointer to a buffer that receives the data from the MIB entry.

Return value

If the function succeeds, the return value is NO_ERROR.

If the function fails, the return value is one of the following values.

Value Description
ERROR_CAN_NOT_COMPLETE

The operation failed.

ERROR_INVALID_PARAMETER

The size or content of the input data is incompatible with the request.

ERROR_INSUFFICIENT_BUFFER

The size of the output buffer provided is not large enough to hold the requested information. On return, the required size is pointed to by the OutputDataSize parameter.

 

 

Requirements

Minimum supported client

None supported

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Routprot.h

See also

Protocol Identifiers

MIBEntryGet

MIBEntryGetNext