3.3.4.100 GetSchemaConversionInfo

The GetSchemaConversionInfo operation is used to check whether a conversion of the IPAM data store schema is required. This check is performed before the IPAM system update.

 <wsdl:operation name="GetSchemaConversionInfo">
   <wsdl:input wsaw:Action="http://Microsoft.Windows.Ipam/IIpamServer/GetSchemaConversionInfo" message="ipam:IIpamServer_GetSchemaConversionInfo_InputMessage" />
   <wsdl:output wsaw:Action="http://Microsoft.Windows.Ipam/IIpamServer/GetSchemaConversionInfoResponse" message="ipam:IIpamServer_GetSchemaConversionInfo_OutputMessage" />
 </wsdl:operation> 

Upon receiving the IIpamServer_GetSchemaConversionInfo_InputMessage request message, the server performs the following processing steps. Upon successful completion of these steps, the server MUST respond with the IIpamServer_GetSchemaConversionInfo_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. Get the current IPAM data store version and the current OS version and the schema version to which IPAM can be upgraded to by reading the properties ADM_IPAMSchemaVersion, ADM_IPAMServerVersion, and ADM_IPAMTargetSchemaVersion respectively.

  2. Assign these to GetSchemaConversionInfoResponse.configuredVersion, GetSchemaConversionInfoResponse.installedVersion, and GetSchemaConversionInfoResponse.nextVersion respectively.

  3. If GetSchemaConversionInfoResponse.configuredVersion is not the same as GetSchemaConversionInfoResponse.installedVersion, then conversion of IPAM data schema would be required. Set GetSchemaConversionInfoResponse.GetSchemaConversionInfoResult to TRUE. Else, set it to FALSE.