IUpdateEndpointProvider::GetServiceEndpoint 方法

  • 项目

请求用于连接到服务的终结点。

语法

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

参数

ServiceId [in]

标识要更新的服务。

endpointType [in]

标识服务实现的终结点类型。

UpdateEndpointType 枚举定义以下常量。

uetClientServer

用于连接到更新服务的客户端-服务器终结点。

uetReporting

客户端向更新服务报告扫描、下载和安装结果时使用的报告终结点

uetWuaSelfUpdate

当客户端计算机联系更新服务以查看是否有新版本的 Windows 更新代理客户端软件时使用的自我更新终结点。

uetRegulation

当客户端计算机联系监管服务以对适用于目标计算机的特定更新执行操作时使用的监管终结点。

uetSimpleTargeting

仅用于专用服务（企业环境中的 WSUS 服务器）的简单目标终结点。

proxySettings [in]

标识连接到代理服务器时使用的设置。

hUserToken [in]

包含表示用户的令牌句柄对象。 终结点提供程序使用此令牌来确定要使用的代理设置和凭据。

fRefreshOnline [in]

指示 WUA 是否请求新令牌。 True 指示请求新令牌。 False 指示请求新的或缓存的令牌。 有关详细信息，请参阅注解。

pbstrEndpointLoc [out]

指定用于与服务通信的 URL。 例如，对于客户端-服务器终结点，这是客户端服务器服务的 URL。 有关详细信息，请参阅注解。

返回值

成功时返回 S_OK。 否则，返回 COM 或 Windows 错误代码。

备注

首次调用此方法时，WUA 通常会将 fRefreshOnline 参数设置为 false，然后，再次调用该方法时，如果发生连接错误，WUA 会将该参数设置为 true。 但是，此方法的实现可以随时从安全令牌服务 (STS) 请求新令牌或提供缓存的令牌。

如果终结点不需要身份验证，则调用方只需使用 pbstrEndpointLoc 参数指定的 URL 即可连接到服务。

如果终结点确实需要身份验证，则调用方可以使用 pbstrEndpointLoc 参数指定的 URL 和其他参数提供的数据。

要求

要求 值
最低受支持的客户端
 Windows XP、带 SP3 的 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器
 Windows Server 2003、带 SP3 的 Windows 2000 Server [仅限桌面应用]
标头
UpdateEndpointAuth.h
IDL
UpdateEndpointAuth.idl
库
UpdateEndpointAuth.lib
DLL
UpdateEndpointAuth.dll

另请参阅

IUpdateEndpointProvider