Método IUpdateEndpointProvider::GetServiceEndpoint

Solicita un punto de conexión que se usa para conectarse a un servicio.

Sintaxis

HRESULT GetServiceEndpoint(
  [in]  GUID                        ServiceId,
  [in]  UpdateEndpointType          endpointType,
  [in]  UpdateEndpointProxySettings proxySettings,
  [in]  HANDLE_PTR                  hUserToken,
  [in]  BOOL                        fRefreshOnline,
  [out] BSTR                        *pbstrEndpointLoc
);

Parámetros

ServiceId [in]

Identifica el servicio que se va a actualizar.

endpointType [in]

Identifica el tipo de punto de conexión implementado por el servicio.

La enumeración UpdateEndpointType define las siguientes constantes.

uetClientServer

Punto de conexión de cliente-servidor que se usa para conectarse al servicio de actualización.

uetReporting

Un punto de conexión de creación de informes que se usa cuando el cliente notifica los resultados de digitalizaciones, descargas e instala de nuevo en el servicio de actualización

uetWuaSelfUpdate

Un punto de conexión de actualización automática que se usa cuando el equipo cliente se pone en contacto con un servicio de actualización para ver si hay una nueva versión del software cliente del agente de Windows Update.

uetRegulation

Punto de conexión de reglamento que se usa cuando el equipo cliente se pone en contacto con el servicio de regulación para reaccionar ante una actualización determinada que se aplica al equipo de destino.

uetSimpleTargeting

Un punto de conexión de destino simple que solo se usa con servicios privados (servidores WSUS en entornos corporativos).

proxySettings [in]

Identifica la configuración que se usa al conectarse a un servidor proxy.

hUserToken [in]

Contiene un objeto de identificador de token que representa al usuario. El proveedor de puntos de conexión usa este token para determinar qué configuración de proxy y credenciales se van a usar.

fRefreshOnline [in]

Indica que WUA de tiempo solicita un nuevo token. True indica que se solicita un nuevo token. False indica que se solicita un token nuevo o almacenado en caché. Consulte Comentarios para más información.

pbstrEndpointLoc [out]

Especifique la dirección URL que se usa para comunicarse con el servicio. Por ejemplo, para un punto de conexión de cliente-servidor, esta sería la dirección URL del servicio de servidor cliente. Consulte Comentarios para más información.

Valor devuelto

Devuelve S_OK si se ejecuta correctamente. De lo contrario, devuelve un código de error COM o Windows.

Comentarios

WUA normalmente establece el parámetro fRefreshOnline en false cuando se llama por primera vez a este método. Si se produce un error de conexión, WUA establece ese parámetro en true cuando se llama al método de nuevo. Sin embargo, la implementación de este método puede solicitar un nuevo token desde un servicio de token de seguridad (STS) o proporcionar un token almacenado en caché en cualquier momento.

Si el punto de conexión no necesita autenticación, el autor de la llamada puede conectarse al servicio con solo la dirección URL especificada por el parámetro pbstrEndpointLoc.

Si el punto de conexión necesita autenticación, el autor de la llamada puede usar la dirección URL especificada por el parámetro pbstrEndpointLoc y los datos proporcionados por los demás parámetros.

Requisitos

Requisito	Valor
Cliente mínimo compatible	Windows XP, Windows 2000 Professional con SP3 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003, Windows 2000 Server con SP3 [solo aplicaciones de escritorio]
Encabezado	UpdateEndpointAuth.h
IDL	UpdateEndpointAuth.idl
Biblioteca	UpdateEndpointAuth.lib
Archivo DLL	UpdateEndpointAuth.dll

Consulte también

IUpdateEndpointProvider