UpdateEndpointType enumeration

Defines the type of endpoints that can be used to connect to a service.

Syntax

typedef enum tagEndpointType { 
  uetClientServer          = 0,
  uetReporting             = ( uetClientServer + 1 ),
  uetWuaSelfUpdate         = ( uetReporting + 1 ),
  uetRegulation            = ( uetWuaSelfUpdate + 1 ),
  uetSimpleTargeting       = ( uetRegulation + 1 ),
  uetSecuredClientServer   = ( uetSimpleTargeting + 1 ),
  uetSecondaryServiceAuth  = ( uetSecuredClientServer + 1 )
} UpdateEndpointType;

Constants

uetClientServer

A client-server endpoint that is used to connect to the update service, such as Windows Update, Microsoft Update, and WSUS server in a corporate environment, to find information on updates that may be applicable to the computer.

The update service returns information on updates that have been published, revised, or withdrawn since the last time that client performed a sync with the server.

uetReporting

A reporting endpoint that is used when the client reports the results of scans, downloads, and installs back to the update service.

In the case of public services (Windows Update and Microsoft Update), this is done for quality monitoring purposes.

In the case of private services, such as a corporate WSUS server, this type of endpoint also allows the server to collect inventory and other information about the client computers under management.

uetWuaSelfUpdate

A self-update endpoint that is used when the client computer contacts an update service to see whether there is a new version of the Windows Update Agent client software.

The Self-update endpoint uses a different protocol then the Client-Server endpoint so that self-updates can be distributed even if there is an error condition that might be preventing the normal client-server sync from working on a particular client computer.

uetRegulation

A regulation endpoint that is used when the client computer contacts the regulation service to act on a particular update that is applicable to the target computer.

The regulation service can indicate whether the update is “regulated” (also known as “throttled”) – in other words, the regulation service can tell the client computer that it should not act on a particular update, even though that update appears to be applicable.

uetSimpleTargeting

A simple-targeting endpoint that is used only with private services (WSUS servers in corporate environments). In a corporate environment, client computers can be assigned to particular target groups, and updates can be approved for installation on computers in some groups but not others.

For example, the WSUS administrator may create a “Testing” group for computers that are used to test new updates, and the administrator may approve newly-released updates for installation on computers in the Testing group without approving them for installation on other computers in the organization. The simple targeting exchange is used to allow a client computer to register itself with the WSUS server, and to allow the server to tell the client computer what group it is in.

uetSecuredClientServer

A secured-client-server endpoint that allows a client to obtain info on apps that need licensing so they can be used on a client computer. This licensing framework is currently only used by Windows 8 to deploy apps and updates that are obtained through the Windows Store. The secured-client-server endpoint is currently not used by Windows Update, Microsoft Update, or WSUS.

uetSecondaryServiceAuth

The secondary-service-authentication endpoint is used by a client to provide authentication before it obtains info on apps that need licensing so they can be used on a client computer. This licensing framework is currently only utilized by Windows 8 to deploy apps and updates that are obtained through the Windows Store. The secondary-service-authentication endpoint is currently not used by Windows Update, Microsoft Update, or WSUS.

Requirements

Requirement Value
Minimum supported client
Windows 8 [desktop apps only]
Minimum supported server
Windows Server 2012 [desktop apps only]
Header
UpdateEndpointAuth.h
IDL
UpdateEndpointAuth.idl