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: ULONGQualifiers: [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.
Note Uninstall of updates through this interface is not currently supported.
- bIncludeHidden
- Data type: VARIANT_BOOLQualifiers: [in]VARIANT_FALSE to
retrieve only the updates that are available through the client
user interface.
Note In quiet mode, set this parameter to VARIANT_TRUE to retrieve the updates through this method.
- pvarProgress
- Data type: VARIANTQualifiers: [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: LPICCMUpdatesCollectionQualifiers: [out, retval]Pointer to an ICCMUpdatesCollection Interface object representing the collection of software updates for deployment.
Return Values
An HRESULT code. Possible values include, but are not limited to, the following:
- S_OK
- The method succeeded.
Remarks
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.
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
Send comments about this topic to Microsoft.