Share via

3.1.4.32 RMIBEntryGetNext (Opnum 31)

  • Article

The RMIBEntryGetNext method<297> retrieves the next (to the previous call) entry corresponding to the transport, protocol, and the MIB entry specified in pInfoStuct.

 DWORD 
 RMIBEntryGetNext(
   [in] DIM_HANDLE hDimServer,
   [in] DWORD dwPid,
   [in] DWORD dwRoutingPid,
   [in, out] PDIM_MIB_ENTRY_CONTAINER pInfoStuct
 );

hDimServer: A handle to the RRASM server where the call is to be executed, see section 3.1.3.

dwPid: The same as in RMIBEntryGet (section 3.1.4.30).  

dwRoutingPid: The same as in RMIBEntryGetFirst (section 3.1.4.31).  

pInfoStuct: The same as in RMIBEntryGet (section 3.1.4.30).  

Return Values: A 32-bit, unsigned integer value that indicates return status. A return value of ERROR_SUCCESS (0x00000000) indicates that the operation was completed successfully; otherwise, the value contains an error code, as specified in [MS-ERREF] or in section 2.2.4. All values that are not in the table that follows MUST be treated the same by the RRASM client.

Return value/code

Description

ERROR_SUCCESS

0x00000000

The call was successful.

ERROR_ACCESS_DENIED

0x00000005

The calling application does not have sufficient privileges, as specified in section 2.1.1.1.

ERROR_NO_MORE_ITEMS

0x00000103

No more data available.

The opnum field value for this method is 31.

When processing this call, the RRASM server MUST do the following:

  • Validate, as specified in section 2.1.1.1, whether this method was called by a client that has access to the method. If the client does not have access, then return error ERROR_ACCESS_DENIED (0x00000005).

  • If pInfoStuct is NULL, return an error other than those in the preceding table.

  • If dwPid is not specified in the SupportedTransportsList, return an error other than those specified in the preceding table.

  • Call the abstract interface Invoke DIMSVC method specifying the operation and the parameters to enable RRAS server to perform the required management task.

  • Return any error status returned by the RRAS server while processing the request. Otherwise fill the MIB information returned by the RRAS server in the pInfoStruct. If there are no more MIB entries to be returned, the RRAS server MUST return ERROR_NO_MORE_ITEMS<298>; otherwise, return ERROR_SUCCESS (0x00000000).

No exceptions are thrown beyond those thrown by the underlying RPC protocol [MS-RPCE].