ICCMUpdatesDeployment::InstallUpdates Method

Article
05/03/2011

Applies To: System Center Configuration Manager 2007, System Center Configuration Manager 2007 R2, System Center Configuration Manager 2007 R3, System Center Configuration Manager 2007 SP1, System Center Configuration Manager 2007 SP2

The InstallUpdates method, in Configuration Manager, installs an array of software updates that have been deployed to the client computer.

[IDL]
HRESULT InstallUpdates(
      const VARIANT arrUpdates,
      const CCM_CONTENTPRIORITY eContentPriority,
      const ULONG ulOptions
);

Parameters

arrUpdates
Data type: VARIANT

Qualifiers: [in]

An array of IDs of software updates to install. The caller uses the ICCMUpdatesDeployment::EnumerateUpdates Method to obtain the collection of updates to be installed and their IDs.

eContentPriority
Data type: CCM_CONTENTPRIORITY

Qualifiers: [in]

The download priority of the update content binaries. Possible values are:

0

PriorityForeground

1

PriorityHigh

2

PriorityMedium

3

PriorityLow

ulOptions
Data type: ULONG

Qualifiers: [in]

Flags that affect the installation job behavior. Possible values are combinations (bitwise OR) of the following, defined by the EUpdateJobOptions enumeration:

0x0001	UPDATE_CHECK_LOCATIONS
0x0002	UPDATE_FORCED_SCAN
0x0004	UPDATE_WAIT_AU_AVAILABILITY
0x0008	UPDATE_IGNORE_SERVICEWINDOW
0x0010	UPDATE_IGNORE_REBOOTWINDOW
0x0020	UPDATE_RETRY_DETECT_ON_FAILURE
0x0040	UPDATE_RAISE_MOMALERTS_ON_FAILURE
0x0080	UPDATE_DISABLE_NONSMS_MOMALERTS

Return Values

An HRESULT code. Possible values include, but are not limited to, the following:

S_OK
The method succeeded.

Remarks

The updates to install using this method must be in the available list as updates that are missing on the client computer.

Requirements

Runtime Requirements

For more information, see Configuration Manager Client Runtime Requirements.

Development Requirements

For more information, see Configuration Manager Client Development Requirements.