3.2.4.32 R_DhcpGetMCastMibInfo (Opnum 31)
The R_DhcpGetMCastMibInfo method retrieves the multicast counter values of the MADCAP 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_DhcpGetMCastMibInfo( [in, unique, string] DHCP_SRV_HANDLE ServerIpAddress, [out] LPDHCP_MCAST_MIB_INFO* MibInfo );
ServerIpAddress: The IP address/host name of the MADCAP server. This parameter is unused.
MibInfo: This is of type LPDHCP_MCAST_MIB_INFO, pointing to the location that contains the multicast MIB information of the MADCAP 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 31.
When processing this call, the MADCAP 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 the server ADM element DHCPv4ServerMcastMibInfo and copy the information in it to the MibInfo structure.
Set the Scopes field of the MibInfo structure to the number of entries in DHCPv4MScopesList.
Incrementally calculate the statistics for all the DHCPv4MScope objects in DHCPv4MScopesList and copy them to the ScopeInfo field of the MibInfo structure.
Exceptions Thrown: No exceptions are thrown beyond those thrown by the underlying RPC protocol [MS-RPCE].