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.

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>