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