3.38.1 Abstract Data Model

This section describes a conceptual model of possible data organization that an implementation maintains to participate in this protocol. The described organization is provided to facilitate the explanation of how the protocol behaves. This document does not mandate that implementations adhere to this model as long as their external behavior is consistent with that described in this document.

An IUpdateSearcher server maintains the following data elements:

  • Locale: An LCID identifying the locale for localized data returned from method calls on instances in the object graph returned by method calls on this instance. Once initialized, this data element is not modified.

  • CanAutomaticallyUpgradeService: A VARIANT_BOOL that controls whether a search performed by using this instance can automatically upgrade the update agent. This data element can be modified.

  • ClientApplicationID: The string used to identify the client application that is using this instance. This data element can be modified.

  • IncludePotentiallySupersededUpdates: A VARIANT_BOOL that controls whether a search performed by using this instance includes updates that are superseded by other updates in the search results. This data element can be modified.

  • ServerSelection: A value from the ServerSelection (section 2.2.11) enumeration indicating the type of update server to be used to perform searches by using this instance. This data element can be modified.

  • ServiceID: A string containing the unique identifier of the update server to be used to perform searches by using this instance. This data element can be modified.

  • HistoryList: A list of IUpdateHistoryEntry instances representing all history entries recorded by the update agent, sorted by date in descending order. Once initialized, this data element is never modified.

  • HistoryCount: A count of the items in HistoryList. Once initialized, this data element is not modified.

  • Online: A VARIANT_BOOL that controls whether a search performed by using this instance is to go online. This data element can be modified.

  • IgnoreDownloadPriority: A VARIANT_BOOL that, if set to VARIANT_TRUE, causes an update's download priority to be ignored when computing update supersedence. This data element can be modified.

  • SearchScope: A value from the SearchScope (section 2.2.12) enumeration indicating the scope of the search operation. This data element can be modified.