3.3.4.110 GetTotalUnmappedRanges

The GetTotalUnmappedRanges operation can be used to get the number of address ranges that are not mapped to any address block.

 <wsdl:operation name="GetTotalUnmappedRanges">
   <wsdl:input wsaw:Action="http://Microsoft.Windows.Ipam/IIpamServer/GetTotalUnmappedRanges" message="ipam:IIpamServer_GetTotalUnmappedRanges_InputMessage" />
   <wsdl:output wsaw:Action="http://Microsoft.Windows.Ipam/IIpamServer/GetTotalUnmappedRangesResponse" message="ipam:IIpamServer_GetTotalUnmappedRanges_OutputMessage" />
 </wsdl:operation>

Upon receiving the IIpamServer_GetTotalUnmappedRanges_InputMessage request message, the server performs the following processing steps. Upon successful completion of these steps, the server MUST respond with the IIpamServer_GetTotalUnmappedRanges_OutputMessage message. In the event of a failure, an appropriate SOAP fault MUST be sent to the client as specified in section 2.2.2.1:

  1. Set a temp data store, count to 0.

  2. For each row in the ADM_IPRangeTable where AddressSpaceId is equal to default address space Id:

    1. Get the IPBlock that the range in this row maps to, by calling GetIPBlockFromTable of ADM_IPBlocksTable passing the following parameters:

      1. Assign the ParentIPBlockRecordId of the current row to Param_blockId.

      2. Assign GetTotalUnmappedRanges.addressFamily to Param_addressFamily.

    2. If the block has its ParentBlockRecordId set to NULL, then increase the count by 1.

  3. Set the count computed above to GetTotalUnmappedRangesResponse.GetTotalUnmappedRangesResult.