SearchScope enumeration

Defines the variety of updates that should be returned by the search: per-machine updates, per-user updates, or both.

Syntax

typedef enum  { 
  searchScopeDefault                = 0,
  searchScopeMachineOnly            = 1,
  searchScopeCurrentUserOnly        = 2,
  searchScopeMachineAndCurrentUser  = 3,
  searchScopeMachineAndAllUsers     = 4,
  searchScopeAllUsers               = 5
} SearchScope;

Constants

searchScopeDefault

Search by using the default scope (the scope that Automatic Updates would use when searching for updates). This is currently equivalent to search ScopeMachineOnly.

searchScopeMachineOnly

Search only for per-machine updates; exclude all per-user updates.

searchScopeCurrentUserOnly

Search only for per-user updates applicable to the calling user – the user who owns the process which is making the Windows Update Agent (WUA) API call.

searchScopeMachineAndCurrentUser

[Not currently supported.] Search for per-machine updates and for per-user updates applicable to the current user.

searchScopeMachineAndAllUsers

[Not currently supported.] Search for per-machine updates and for per-user updates applicable to any known user accounts on the computer.

searchScopeAllUsers

[Not currently supported.] Search only for per-user updates applicable to any known user accounts on the computer.

Remarks

In versions of the Windows Update Agent that do not support per-user updates (versions that do not support the IUpdateSearcher3 interface), searches will always return only per-machine updates.

Requirements

Send comments about this topic to Microsoft

Build date: 11/22/2012