Share via

3.2.4.69 R_DhcpGetMibInfoV6 (Opnum 68)

  • Article

The R_DhcpGetMibInfoV6 method is used to retrieve the IPv6 counter values of the DHCPv6 server. The caller of this function can free the memory pointed to by MibInfo by calling the function midl_user_free (section 3).

 DWORD R_DhcpGetMibInfoV6(
   [in, unique, string] DHCP_SRV_HANDLE ServerIpAddress,
   [out] LPDHCP_MIB_INFO_V6* MibInfo
 );

ServerIpAddress: The IP address/host name of the DHCP server. This parameter is unused.

MibInfo: This is a pointer of type LPDHCP_MIB_INFO_V6 that points to the location that contains IPv6 MIB information about the DHCPv6 server.

Return Values: A 32-bit unsigned integer value that indicates return status. A return value ERROR_SUCCESS (0x00000000) indicates that the operation was completed successfully, else it contains a Win32 error code, as specified in [MS-ERREF]. This error code value can correspond to a DHCP-specific failure, which takes a value between 20000 and 20099, or any generic failure.

Return value/code

Description

0x00000000

ERROR_SUCCESS

The call was successful.

The opnum field value for this method is 68.

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

  • Validate if this method is authorized for read access per section 3.5.4. If not, return the error ERROR_ACCESS_DENIED.

  • Retrieve all the statistics stored in the server ADM element DHCPv6ServerMibInfo, and copy them to the corresponding fields of MibInfo.

  • Retrieve all the DHCPv6Scope objects from DHCPv6ScopeList and set Scopes equal to number of entries in DHCPv6ScopeList.

  • Incrementally calculate the statistics for all the DHCPv6Scope objects retrieved and copy them into ScopeInfo field of MibInfo.

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