2.2.2.2.7 GetFileLocations

  • Article

Synopsis:

Returns the URL where the specified set of files can be found.

 <wsdl:operation name="GetFileLocations" />

The SOAP operation is defined as follows.

 <soap:operation soapAction="http://www.microsoft.com/
    SoftwareDistribution/Server/ClientWebService/GetFileLocations" 
    style="document" />

Request:

 <s:element name="GetFileLocations">
   <s:complexType>
     <s:sequence>
       <s:element minOccurs="0" maxOccurs="1" name="cookie" 
          type="s1:Cookie" />
       <s:element minOccurs="0" maxOccurs="1" name="fileDigests" 
          type="s1:ArrayOfBase64Binary" />
     </s:sequence>
   </s:complexType>
 </s:element>

cookie: Specifies a cookie that was obtained from a previous call to GetCookie (section 2.2.2.2.2), GetFileLocations (section 2.2.2.2.7), or SyncUpdates (section 2.2.2.2.4). This element MUST be present.

fileDigests: An array of digests for content corresponding to updates. Each digest MUST be specified as a SHA1 hash. The format is specified in section 2.2.3.7.

Response:

 <s:element name="GetFileLocationsResponse">
   <s:complexType>
     <s:sequence>
       <s:element minOccurs="0" maxOccurs="1" name="GetFileLocationsResult" 
          type="s1:GetFileLocationsResults" />
     </s:sequence>
   </s:complexType>
 </s:element>

GetFileLocationsResults: Upon successful completion of the operation, this element MUST be returned. Its format is as follows.

 <s:complexType name="GetFileLocationsResults">
   <s:sequence>
     <s:element minOccurs="0" maxOccurs="1" name="FileLocations" 
        type="s1:ArrayOfFileLocation" />
     <s:element minOccurs="0" maxOccurs="1" name="NewCookie" 
        type="s1:Cookie" />
   </s:sequence>
 </s:complexType>

FileLocations: The file locations for the files. Its format is specified in section 2.2.2.2.6.

NewCookie: A replacement cookie, generated by the server, that SHOULD be provided by the client in subsequent method invocations.