3.5.4.4 InitializeEnumeration

The InitializeEnumeration operation is an initiating operation. This operation is used to specify the type of object that is to be enumerated using the enumeration session and the enumeration parameters itself.

 <wsdl:operation msc:isInitiating="true" msc:isTerminating="false" name="InitializeEnumeration">
   <wsdl:input wsaw:Action="http://Microsoft.Windows.Ipam/IIpamEnumerator/InitializeEnumeration" message="ipam:IIpamEnumerator_InitializeEnumeration_InputMessage" />
   <wsdl:output wsaw:Action="http://Microsoft.Windows.Ipam/IIpamEnumerator/InitializeEnumerationResponse" message="ipam:IIpamEnumerator_InitializeEnumeration_OutputMessage" />
 </wsdl:operation>

Upon receiving the IIpamEnumerator_InitializeEnumeration_InputMessage request message, the server performs the following processing steps. Upon successful completion of the steps specified below, the server MUST respond with the IIpamEnumerator_InitializeEnumeration_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. The session state is set to Enumeration Initialized.

  2. The InitializeEnumeration.parameters.objectType MUST be a valid value of EnumerationObjectType and MUST NOT be None.

  3. The InitializeEnumeration.parameters MUST be valid as per their definitions given in section 2.2.4. If the data is valid assign InitializeEnumeration.parameters to EnumInputParameters.

  4. If the validation of the InitializeEnumeration.parameters done fails, an appropriate SOAP fault MUST be sent to the client as specified in section 2.2.2.1.