4.4 List Update Classifications

This example illustrates how to list available update classifications by using the ExecuteSPGetCategories (section 3.1.4.6) WSDL operation.

Listing available update classifications

Figure 8: Listing available update classifications

The protocol client implementation constructs the following WSDL message:

  
 <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <soap:Body>
     <ExecuteSPGetCategories xmlns="http://www.microsoft.com/SoftwareDistribution/Server/ApiRemotingWebService">
       <preferredCulture>en</preferredCulture>
       <retrieveUpdateClassifications>true</retrieveUpdateClassifications>
       <fromSyncDate>0001-01-01T00:00:00</fromSyncDate>
       <toSyncDate>9999-12-31T23:59:59.9999999</toSyncDate>
     </ExecuteSPGetCategories>
   </soap:Body>
 </soap:Envelope>

The protocol server implementation constructs the following response.

Note The response message has been shortened for the sake of clarity.

  
 <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <soap:Body>
     <ExecuteSPGetCategoriesResponse xmlns="http://www.microsoft.com/SoftwareDistribution/Server/ApiRemotingWebService">
       <ExecuteSPGetCategoriesResult>
         <GenericReadableRow>
           <Values>
             <anyType xsi:type="xsd:int">5</anyType>
             <anyType xmlns:q3="http://microsoft.com/wsdl/types/" xsi:type="q3:guid">0fa1201d-4330-4fa8-8ae9-b877473b6441</anyType>
             <anyType xsi:type="xsd:string">UpdateClassification</anyType>
             <anyType xsi:type="xsd:boolean">true</anyType>
             <anyType xsi:type="xsd:boolean">false</anyType>
             <anyType xsi:type="xsd:int">4</anyType>
             <anyType xsi:nil="true" />
             <anyType xsi:type="xsd:string">Security Updates</anyType>
             <anyType xsi:type="xsd:string">A broadly released fix for a product-specific security-related vulnerability. Security vulnerabilities are rated based on their severity which is indicated in the Microsoftbulletin as critical, important, moderate, or low.</anyType>
             <anyType xsi:nil="true" />
             <anyType xsi:type="xsd:dateTime">2013-09-13T18:55:51.377</anyType>
             <anyType xsi:type="xsd:int">0</anyType>
           </Values>
         </GenericReadableRow>
         <GenericReadableRow>
           <Values>
             <anyType xsi:type="xsd:int">1</anyType>
             <anyType xmlns:q9="http://microsoft.com/wsdl/types/" xsi:type="q9:guid">e6cf1350-c01b-414d-a61f-263d14d133b4</anyType>
             <anyType xsi:type="xsd:string">UpdateClassification</anyType>
             <anyType xsi:type="xsd:boolean">true</anyType>
             <anyType xsi:type="xsd:boolean">false</anyType>
             <anyType xsi:type="xsd:int">0</anyType>
             <anyType xsi:nil="true" />
             <anyType xsi:type="xsd:string">Critical Updates</anyType>
             <anyType xsi:type="xsd:string">A broadly released fix for a specific problem addressing a critical, non-security related bug.</anyType>
             <anyType xsi:nil="true" />
             <anyType xsi:type="xsd:dateTime">2013-09-13T18:55:49.36</anyType>
             <anyType xsi:type="xsd:int">0</anyType>
           </Values>
         </GenericReadableRow>
         <GenericReadableRow>
           <Values>
             <anyType xsi:type="xsd:int">2</anyType>
             <anyType xmlns:q10="http://microsoft.com/wsdl/types/" xsi:type="q10:guid">ebfc1fc5-71a4-4f7b-9aca-3b9a503104a0</anyType>
             <anyType xsi:type="xsd:string">UpdateClassification</anyType>
             <anyType xsi:type="xsd:boolean">true</anyType>
             <anyType xsi:type="xsd:boolean">false</anyType>
             <anyType xsi:type="xsd:int">1</anyType>
             <anyType xsi:nil="true" />
             <anyType xsi:type="xsd:string">Drivers</anyType>
             <anyType xsi:type="xsd:string">A software component necessary to control or regulate another device.</anyType>
             <anyType xsi:nil="true" />
             <anyType xsi:type="xsd:dateTime">2013-09-13T18:55:50.833</anyType>
             <anyType xsi:type="xsd:int">0</anyType>
           </Values>
         </GenericReadableRow>
         <!-- further classification omitted -->
       </ExecuteSPGetCategoriesResult>
     </ExecuteSPGetCategoriesResponse>
   </soap:Body>
 </soap:Envelope>