Partager via


ICCMUpdatesDeployment::InstallUpdates Method

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.

See Also

Concepts

ICCMUpdatesDeployment Interface
ICCMUpdatesDeployment::UninstallUpdates Method
ICCMUpdatesDeployment::EnumerateUpdates Method
About Software Updates Deployments
How to Install Software Updates