Revision Summary Date Revision History Revision Class Comments 12/18/2009 0.1 First Release. 1/29/2010 0.1.1 Editorial Changed language and formatting in the technical content. 3/12/2010 1.0 Major Updated and revised the technical content. 4/23/2010 2.0 Major Updated and revised the technical content. 6/4/2010 2.1 Clarified the meaning of the technical content. 7/16/2010 3.0 Updated and revised the technical content. 8/27/2010 3.1 Clarified the meaning of the technical content. 10/8/2010 3.1 None No changes to the meaning, language, or formatting of the technical content. 11/19/2010 3.2 Minor Clarified the meaning of the technical content. 1/7/2011 3.2 None No changes to the
meaning, language, or formatting of the technical content. 7/12/2012 5.0 Updated and revised the technical content. 10/25/2012 5.0 None No changes to the meaning, language, or formatting of the technical content. 1/31/2013 5.0 None No changes to the meaning, language, or formatting of the technical content. 8/8/2013 6.0 Major Updated and revised the technical content. 11/14/2013 6.0 None No changes to the meaning, language, or formatting of the technical content. 2/13/2014 7.0 Major Updated and revised the technical content. 5/15/2014 7.0 None No changes to the meaning, language, or formatting
} DownloadPriority; dpLow: The update service recommends that the update agent SHOULD use fewer resources to download the update than it uses for updates with dpNormal or dpHigh priority. dpNormal: The update service recommends that the update SHOULD use more resources to download the update than it uses for updates with dpLow priority, but fewer resources than it uses for updates with dpHigh priority. dpHigh: The update service recommends that the update SHOULD use more resources to download the update than it uses for updates with dpLow or dpNormal priority. dpExtraHigh: The update service recommends that the update agent SHOULD use all available resources to download the update as quickly as possible. AutoSelectionMode The AutoSelectionMode enumeration defines values describing the recommendation for whether an update is automatically selected in a user interface (UI). typedef enum tagAutoSelectionMode { asLetWindowsUpdateDecide = 0, asAutoSelectIfDownloaded = 1, asNeverAutoSelect = 2, asAlwaysAutoSelect = 3, } AutoSelectionMode; asLetWindowsUpdateDecide: The update service recommends that a user interface implementation SHOULD decide whether to automatically select the update. This decision is implementation-specific and can involve other properties of the update and/or the administrator's configuration of the user interface. <2> asAutoSelectIfDownloaded: The update service recommends that a user interface implementation SHOULD automatically select the update if the update is already downloaded. asNeverAutoSelect: The update service recommends that a user interface implementation SHOULD NOT automatically select the update. asAlwaysAutoSelect: The update service recommends that a user interface implementation SHOULD automatically select the update. AutoDownloadMode The AutoDownloadMode enumeration defines values describing the recommendation for whether an update is downloaded automatically by an update agent. typedef enum tagAutoDownloadMode { adLetWindowsUpdateDecide = 0, adNeverAutoDownload = 1, adAlwaysAutoDownload = 2, } AutoDownloadMode; adLetWindowsUpdateDecide: The update service recommends that the update agent SHOULD decide on its own whether to automatically download the update. This decision is and can involve other properties of the update and/or the administrator's configuration of
Return Values: The method MUST return information in an HRESULT data structure. The severity bit in the structure identifies the following conditions: If the severity bit is set to 0, the method completed successfully. If the severity bit is set to 1, the method failed and encountered a error. Exceptions Thrown: No exceptions are thrown beyond those thrown by the underlying RPC protocol . The server SHOULD return the value of the BundledUpdates ADM element. IUpdate::CanRequireSource 11) The IUpdate::CanRequireSource (opnum 11) method retrieves whether the installation of the update can require source media. HRESULT CanRequireSource( [out, retval] VARIANT_BOOL* retval ); retval: MUST be VARIANT_TRUE if the update can require source media or VARIANT_FALSE if the update never requires source media. Return Values: The method MUST return information in an HRESULT data structure. The severity bit in the structure identifies the following conditions: If the severity bit is set to 0, the method completed successfully. If the severity bit is set to 1, the method failed and encountered a fatal error. Exceptions Thrown: No exceptions are thrown beyond those thrown by the underlying RPC protocol . The server SHOULD return the value of the CanRequireSource ADM element. IUpdate::Categories (Opnum 12) The IUpdate::Categories 12) method retrieves a collection of the categories to which the update belongs. HRESULT Categories( [out, retval] ICategoryCollection** retval ); retval: An ICategoryCollection instance containing the categories to which this update belongs. Return Values: The method MUST return information in an HRESULT data structure. The severity bit in the structure identifies the following conditions: If the severity bit is set to 0, the method completed successfully. If the severity bit is set to 1, the method failed and encountered a error. Exceptions Thrown: No exceptions are thrown beyond those thrown by the underlying RPC protocol . The server SHOULD return the value of the Categories ADM element.
0 1 The value determines whether the search operation finds updates that are intended for processing by an automatic update agent. = 0 1 The value is treated as a Boolean. The determines whether the search operation finds updates that are intended to be automatically selected from web user interfaces. BrowseOnly = 0 1 The value is treated as a Boolean. The value determines whether the search operation finds updates that are not intended for processing by an automatic update agent. UpdateID =, != Compares the update's ID to that given.
Index _ _NewEnum method ( 45, 67, 112, 120, 126, 139, 169, 188) A Abstract data model client ( 34, 37, 43, 46, 49, 53, 57, 63, 70, 109, 115, 118, 121, 124, 127, 137, 140, 142, 158, 167, 170, 177, 181, 186, 189, 191) 37 37 34 43 46 49 53 57 70 109 109 109 109 109 118 118 121 124 127 137 137 140 142 158 158 158 167 170 177 181 63 63 63 109 109 109 109 109 189 191 server ( 32, 34, 37, 44, 47, 50, 54, 57, 64, 72, 110, 116, 119, 122, 125, 128, 137, 140, 143, 158, 167, 170, 178, 181, 187, 190) 34 34 32 37 44 47 50 54 64 72 72 72 72 72 110 116 116 119 122 125 128 128 137 140 143 143 143 158 158 167 170 170 178 57 57 57 72 72 72 72 72 181 187 190 Add method ( 68, 113) 193 193 173 176 29 48 18 AutoDownload method ( 99, 108) 26 AutoSelection method ( 99, 108) 26 78 B BrowseOnly method ( 97, 106) 78 C CanAutomaticallyUpgradeService method ( 145, 146) 164
51 79 18 Categories method ( 79, 136) 39 235 40 method ( 68, 114) Client abstract data model ( 34, 37, 43, 46, 49, 53, 57, 63, 70, 109, 115, 118, 121, 124, 127, 137, 140, 142, 158, 167, 170, 177, 181, 186, 189, 191) 37 37 34 43 46 49 53 57 70 109 109 109 109 109 118 118 121 124 127 137 137 140 142 158 158 158 167 170 177 181 63 63 63 109 109 109 109 109 189 191 initialization ( 34, 37, 43, 46, 50, 53, 57, 63, 71, 109, 116, 118, 121, 124, 127, 137, 140, 142, 158, 167, 170, 177, 181, 186, 189, 191) 37 37 34 43 46 50 53 57 71 109 109 109 109 109 118 118 121 124 127 137 137 140 142 158 158 158 167 170 177 181 63 63 63 109 109 109 109 109 189 191 events ( 34, 37, 43, 46, 50, 53, 57, 64, 71, 109, 116, 119, 122, 125, 127, 137, 140, 142, 158, 167, 170, 177, 181, 186, 189, 192) 37 37 34 43 46 50 53 57 71 109 109 109 109 109 119 119 122 125 127 137 137 140 142 158 158 158 167 170 177
158 167 170 177 181 64 64 64 109 109 109 109 109 189 191 timers ( 34, 37, 43, 46, 50, 53, 57, 63, 71, 109, 115, 118, 121, 124, 127, 137, 140, 142, 158, 167, 170, 177, 181, 186, 189, 191) 37 37 34 43 46 50 53 57 71 109 109 109 109 109 118 118 121 124 127 137 137 140 142 158 158 158 167 170 177 181 63 63 63 109 109 109 109 109 189 191 ClientApplicationID method ( 59, 59, 133, 146, 147, 175, 175) 19 19 19 19 19 19 19 19 19 19 24 161 124 69 Count method ( 45, 67, 112, 121, 126, 139, 169, 188) 60 62 CveIDs method ( 97, 105) D Data model - abstract client ( 34, 37, 43, 46, 49, 53, 57, 63, 70, 109, 115, 118, 121, 124, 127, 137, 140, 142, 158, 167, 170, 177, 181, 186, 189, 191) 37 37 34 43 46 49 53 57 70 109 109 109 109 109 118 118 121 124 127 137 137 140 142 158 158 158 167 170 177 181 63 63 63 109 109 109 109 109 189 191 server ( 32, 34, 37, 44, 47, 50, 54, 57, 64, 72, 110, 116, 119, 122, 125, 128, 137,
140, 143, 158, 167, 170, 178, 181, 187, 190) 34 34 32 37 44 47 50 54 64 72 72 72 72 72 110 116 116 119 122 125 128 128 137 140 143 143 143 158 158 167 170 170 178 57 57 57 72 72 72 72 72 181 187 190 Data types 24 24 131 80 80 81 25 94 Description method ( 40, 81, 132) 35 DeviceProblemNumber method ( 103, 185) DeviceStatus method ( 103, 185) 95 25 94 117 DriverClass method ( 100, 182) DriverHardwareID method ( 101, 183) DriverManufacturer method ( 101, 183) DriverModel method ( 102, 184) DriverProvider method ( 102, 184) DriverVerDate method ( 102, 185) E 149 81 82 Events client 37 37 34 43 46 50 53 57 71 109 109 109 109 109 119 119 122 125 127 137 137 140 142 158 158 158 167 170 177 181 64 64 64 109 109 109 109 109 189 192 server 37 37 34 43 46 49 53 56 70 109 109
109 109 109 118 118 121 124 127 137 137 140 142 157 157 157 166 166 170 177 177 180 63 63 63 109 109 109 109 109 186 189 191 local - client ( 34, 37, 43, 46, 50, 53, 57, 64, 71, 109, 116, 119, 122, 125, 127, 137, 140, 142, 158, 167, 170, 177, 181, 186, 189, 192) local - server ( 34, 37, 43, 46, 49, 53, 56, 63, 70, 109, 115, 118, 121, 124, 127, 137, 140, 142, 157, 166, 170, 177, 180, 186, 189, 191) timer client 37 37 34 43 46 50 53 57 71 109 109 109 109 109 119 119 121 124 127 137 137 140 142 158 158 158 167 170 177 181 64 64 64 109 109 109 109 109 189 191 server 36 36 33 43 46 49 53 56 70 109 109 109 109 109 118 118 121 124 127 136 136 139 142 157 157 157 166 166 169 177 177 180 63 63 63 109 109 109 109 109 186 189 191 - client ( 34, 37, 43, 46, 50, 53, 57, 64, 71, 109, 116, 119, 121, 124, 127, 137, 140, 142, 158, 167, 170, 177, 181, 186, 189, 191)
timer - server ( 33, 36, 43, 46, 49, 53, 56, 63, 70, 109, 115, 118, 121, 124, 127, 136, 139, 142, 157, 166, 169, 177, 180, 186, 189, 191) Examples 193 193 194 161 F 19 197 G 190 154 16 H 82 48 HResult method ( 123, 131) I 34 34 35 34 36 32 32 33 33 37 37 39 40 40 40 39 41 41 42 42 43 43 45 45 44 83 197 IgnoreDownloadPriority method ( 155, 156) 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 47 47 48 48 48 49 50 50 51 52 52 52 Image method ( 40, 83) 52 196 IncludePotentiallySupersededUpdates method ( 147, 148) 196 17 Initialization client ( 34, 37, 43, 46, 50, 53, 57, 63, 71, 109, 116, 118, 121, 124, 127, 137, 140, 142, 158, 167, 170, 177, 181, 186, 189, 191) 37 37
71 181 186 189 Interfaces - server 34 32 37 43 47 50 54 64 71 110 116 119 122 125 128 137 140 143 158 167 170 178 57 181 186 189 16 84 166 118 84 54 54 55 55 56 56 85 85 161 86 180 IsPresent method ( 96, 105) 162 164 162 64 64 67 68 68 69 67 69 66 66 67 70 86 Item method ( 44, 66, 66, 111, 112, 120, 126, 138, 168, 187) 71 71 78 78 79 79 80 80 81 94 81 95 94 81 82 82 83 83 84 84 84 85 85 86 86 94 86 87 87 88 88 89 89 89 90 90 91 91 92 78 92 93 92 93 71 97 96 96 71 97 71 98 71 99 99 110 110 112 113 114 112 114 111
112 113 115 116 116 117 116 118 119 119 120 121 120 122 122 124 123 123 125 125 126 126 126 128 128 133 131 132 131 130 130 134 134 135 132 135 134 133 131 128 136 137 137 139 139 138 140 140 141 141 143 143 145 146 146 147 149 154 147 148 153 153 149 150 148 149 154 155 143 155 156 143 157 157 158 158 164 161 161 161 162 164 162 160 163 163 164 165 165 166 167 167 169 169 168 170 170 173 172 173 172 174 176 175 175 176 178 178 180 179 180 179 57 57 59 59 60 59 57 61 61 57 62 62 71 103 103 100 101 101
109 109 109 186 189 191 M 87 123 Message processing client ( 34, 37, 43, 46, 50, 53, 57, 64, 71, 109, 116, 118, 121, 124, 127, 137, 140, 142, 158, 167, 170, 177, 181, 186, 189, 191) 37 37 34 43 46 50 53 57 71 109 109 109 109 109 116 118 118 121 124 127 137 137 140 142 158 158 158 167 170 177 181 64 64 64 109 109 109 109 109 189 191 server ( 32, 35, 36, 38, 44, 47, 51, 54, 58, 60, 62, 65, 75, 95, 97, 98, 98, 100, 104, 106, 106, 108, 110, 117, 117, 119, 122, 125, 129, 136, 138, 141, 144, 155, 156, 159, 166, 168, 171, 174, 178, 182, 187, 190) 35 36 32 38 44 47 51 54 65 75 95 97 98 98 110 117 117 119 122 125 129 136 138 141 144 155 156 159 166 168 171 174 178 58 60 62 100 104 106 106 108 182 187 190 Messages 24 24 Methods 35 36 33 33 39 40 40 40 39 41 41 42 42 45 45 44 48 48 48
49 51 52 52 52 55 55 56 56 67 68 68 69 67 69 66 66 67 70 78 78 79 79 80 80 81 94 81 95 94 81 82 82 83 83 84 84 84 85 85 86 86 94 86 87 87 88 88 89 89 89 90 90 91 91 92 78 92 93 92 93 97 96 96 97 98 99 99 112 113 114 112 114 111 112 113 115 117 118 120 121 120 124 123 123 126 126 126 133 131 132 131 130 130 134 134 135 132 135 134 133 131 136 139 139 138 141 141 145 146 146 147 149 154 147 148 153 153 149 150 148 149 154 155 155 156 157 157 164 161
28 SearchScope method ( 157, 157) Security 196 196 91 Sequencing client ( 34, 37, 43, 46, 50, 53, 57, 64, 71, 109, 116, 118, 121, 124, 127, 137, 140, 142, 158, 167, 170, 177, 181, 186, 189, 191) 37 37 34 43 46 50 53 57 71 109 109 109 109 109 116 118 118 121 124 127 137 137 140 142 158 158 158 167 170 177 181 64 64 64 109 109 109 109 109 189 191 server ( 32, 35, 36, 38, 44, 47, 51, 54, 58, 60, 62, 65, 75, 95, 97, 98, 98, 100, 104, 106, 106, 108, 110, 117, 117, 119, 122, 125, 129, 136, 138, 141, 144, 155, 156, 159, 166, 168, 171, 174, 178, 182, 187, 190) 35 36 32 38 44 47 51 54 65 75 95 97 98 98 110 117 117 119 122 125 129 136 138 141 144 155 156 159 166 168 171 174 178 58 60 62 100 104 106 106 108 182 187 190 Server abstract data model ( 32, 34, 37, 44, 47, 50, 54, 57, 64, 72, 110, 116, 119, 122, 125, 128, 137, 140, 143, 158, 167, 170, 178, 181, 187, 190) 34 34 32 37 44 47 50 54 64 72 72 72 72 72 110 116 116 119 122 125 128 128 137
140 143 143 143 158 158 167 170 170 178 57 57 57 72 72 72 72 72 181 187 190 34 34 35 34 36 32 32 33 33 37 37 39 40 40 40 39 41 41 42 42 43 43 45 45 44 47 47 48 48 48 49 50 50 51 52 52 52 initialization ( 32, 35, 38, 44, 47, 51, 54, 58, 65, 75, 110, 116, 119, 122, 125, 129, 138, 141, 144, 159, 168, 171, 178, 182, 187, 190) 35 35 32 38 44 47 51 54 65 75 75 75 75 75 110 116 116 119 122 125 129 129 138 141 144 144 144 159 159 168 171 171 178 58 58 58 75 75 75 75 75 182 187 190 54 54 55 55 56 56 64 64 67 68 68 69 67 69 66 66 67 70 71 71 78 78 79 79
80 80 81 94 81 95 94 81 82 82 83 83 84 84 84 85 85 86 86 94 86 87 87 88 88 89 89 89 90 90 91 91 92 78 92 93 92 93 71 97 96 96 71 97 71 98 71 99 99 110 110 112 113 114 112 114 111 112 113 115 116 116 117 116 118 119 119 120 121 120 122 122 124 123 123 125 125 126 126 126 128 128 133 131 132 131 130 130 134 134 135 132 135 134 133 131 128 136 137 137 139 139 138 140 140 141 141 143 143 145 146 146 147 149 154 147 148 153 153 149 150 148 149 154 155 143 155 156 143 157
109 109 109 109 186 189 191 message processing ( 32, 35, 36, 38, 44, 47, 51, 54, 58, 60, 62, 65, 75, 95, 97, 98, 98, 100, 104, 106, 106, 108, 110, 117, 117, 119, 122, 125, 129, 136, 138, 141, 144, 155, 156, 159, 166, 168, 171, 174, 178, 182, 187, 190) 35 36 32 38 44 47 51 54 65 75 95 97 98 98 110 117 117 119 122 125 129 136 138 141 144 155 156 159 166 168 171 174 178 58 60 62 100 104 106 106 108 182 187 190 overview ( 32, 34, 37, 43, 47, 50, 54, 57, 64, 71, 110, 116, 119, 122, 125, 128, 137, 140, 143, 158, 167, 170, 178, 181, 186, 189) 31 sequencing rules ( 32, 35, 36, 38, 44, 47, 51, 54, 58, 60, 62, 65, 75, 95, 97, 98, 98, 100, 104, 106, 106, 108, 110, 117, 117, 119, 122, 125, 129, 136, 138, 141, 144, 155, 156, 159, 166, 168, 171, 174, 178, 182, 187, 190) 35 36 32 38 44 47 51 54 65 75 95 97 98 98 110 117 117 119 122 125 129 136 138 141 144 155 156 159 166 168 171 174 178 58 60 62 100 104 106 106 108 182 187 190 timer events ( 33, 36, 43, 46, 49, 53, 56, 63, 70, 109, 115, 118, 121, 124, 127, 136, 139, 142, 157, 166, 169, 177, 180, 186, 189, 191) 36 36 33 43 46 49 53 56 70 109 109 109 109 109
109 109 109 109 189 191 server ( 33, 36, 43, 46, 49, 53, 56, 63, 70, 109, 115, 118, 121, 124, 127, 136, 139, 142, 157, 166, 169, 177, 180, 186, 189, 191) 36 36 33 43 46 49 53 56 70 109 109 109 109 109 118 118 121 124 127 136 136 139 142 157 157 157 166 166 169 177 177 180 63 63 63 109 109 109 109 109 186 189 191 Timers client ( 34, 37, 43, 46, 50, 53, 57, 63, 71, 109, 115, 118, 121, 124, 127, 137, 140, 142, 158, 167, 170, 177, 181, 186, 189, 191) 37 37 34 43 46 50 53 57 71 109 109 109 109 109 118 118 121 124 127 137 137 140 142 158 158 158 167 170 177 181 63 63 63 109 109 109 109 109 189 191 server ( 32, 35, 38, 44, 47, 50, 54, 58, 65, 74, 110, 116, 119, 122, 125, 129, 138, 141, 144, 159, 168, 171, 178, 182, 187, 190) 35 35 32 38 44 47 50 54 65 74 74 74 74 74 116 116 119 122 125 129 129 138 141 144 144 144 159 159