3.3.4.106 GetSubnetByNetworkIdAndAddressSpace

The GetSubnetByNetworkIdAndAddressSpace operation is used to retrieve the IP subnet data having the specified record identifier.

 <wsdl:operation name="GetSubnetByNetworkIdAndAddressSpace">
   <wsdl:input wsaw:Action="http://Microsoft.Windows.Ipam/IIpamServer/GetSubnetByNetworkIdAndAddressSpace" message="ipam:IIpamServer_GetSubnetByNetworkIdAndAddressSpace_InputMessage" />
   <wsdl:output wsaw:Action="http://Microsoft.Windows.Ipam/IIpamServer/GetSubnetByNetworkIdAndAddressSpaceResponse" message="ipam:IIpamServer_GetSubnetByNetworkIdAndAddressSpace_OutputMessage" />
 </wsdl:operation> 

Upon receiving the IIpamServer_GetSubnetByNetworkIdAndAddressSpace_InputMessage request message, the server performs the following processing steps. Upon successful completion of these steps, the server MUST respond with the IIpamServer_GetSubnetByNetworkIdAndAddressSpace_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. A SOAP fault is sent if GetSubnetByNetworkIdAndAddressSpace.networkId.addressFamily is NULL or is neither InterNetwork nor InterNetworkV6. If GetSubnetByNetworkIdAndAddressSpace.networkId.addressFamily is InterNetwork, then IPv4-specific tables will be used for further processing. Else IPv6-specific tables will be used for processing.

  2. Get the IP subnet by calling the GetSubnetByNetworkIdAndAddressSpace procedure of the ADM_IPSubnetTable passing the GetSubnetByNetworkIdAndAddressSpace.networkId as Param_NetworkId, GetSubnetByNetworkIdAndAddressSpace.prefixLength as Param_PrefixLength and GetSubnetByNetworkIdAndAddressSpace.addressSpaceRecordId as Param_AddressSpaceRecordId.

  3. Assign the Result_Subnet returned by the previous procedure call to GetSubnetByNetworkIdAndAddressSpaceResponse.GetSubnetByNetworkIdAndAddressSpaceResult.