This topic has not yet been rated - Rate this topic

ICCMUpdatesDeployment::EnumerateUpdates Method

System Center

Updated: October 28, 2009

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 EnumerateUpdates method, in Configuration Manager, determines actionable software updates that are available for the client computer.


[IDL]
HRESULT EnumerateUpdates(
     const ULONG ulUpdateAction,
     const VARIANT_BOOL bIncludeHidden,
     VARIANT* pvarProgress,
     LPICCMUpdatesCollection* ppiUpdatesCollection
);

Parameters

ulUpdateAction
Data type: ULONG

Qualifiers: [in]

Update action. Possible values are:

 

2

UPDATE_ACTION_INSTALL. This setting retrieves all updates that are available to be installed or in the process of being installed.

3

UPDATE_ACTION_UNINSTALL. This setting retrieves updates that are already installed and are available to be uninstalled.

noteNote
Uninstall of updates through this interface is not currently supported.

bIncludeHidden
Data type: VARIANT_BOOL

Qualifiers: [in]

VARIANT_FALSE to retrieve only the updates that are available through the client user interface.

noteNote
In quiet mode, set this parameter to VARIANT_TRUE to retrieve the updates through this method.

pvarProgress
Data type: VARIANT

Qualifiers: [in, out]

Pointer to an unsigned long value within a variant indicating if any job is currently active. Possible values are:

 

0

UPDATE_PROGRESS_NONE

1

UPDATE_PROGRESS_OPTIONAL_INSTALL

2

UPDATE_PROGRESS_MANDATORY_INSTALL

ppiUpdatesCollection
Data type: LPICCMUpdatesCollection

Qualifiers: [out, retval]

Pointer to an ICCMUpdatesCollection Interface object representing the collection of software updates for deployment.

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

S_OK
The method succeeded.

The caller uses the EnumerateUpdates method on a CCMUpdatesDeployment COM Automation Class object to determine what actionable updates are available for the client computer. These updates can then be displayed in the main updates portion of the Configuration Manager console or in another client application-specific way. For implementation instructions, see How to Enumerate Software Updates.

The caller is responsible for releasing the updates collection retrieved in the ppiUpdatesCollection parameter.

Runtime Requirements

Development Requirements

Did you find this helpful?
(1500 characters remaining)
© 2013 Microsoft. All rights reserved.