3.1.5.10 GetFileLocations
Synopsis:
This method is called when the client needs to update its cached FileLocation information. A client MUST invoke this method when another method returns a FileLocationsChanged ErrorCode. A client MAY invoke GetFileLocations at other times when it has a valid cookie and a valid list of fileDigests.
Request Validation:
|
Parameter |
Validation Conditions |
Error Code |
|---|---|---|
|
cookie |
MUST be a valid cookie, issued by this server, that has not expired. |
InvalidCookie, ServerChanged, or CookieExpired |
|
fileDigests |
MUST be present. Each element within this array MUST be 20 bytes in length. |
InvalidParameters |
Response:
Upon successful completion, the server MUST return a GetFileLocationsResponse message to the client. The message MUST include file locations for content matching the specified SHA1 hashes, although the file location itself is implementation-specific.<40>