IUpdateEndpointAuthProvider::GetEndpointToken 方法

  • 项目

使用指定的凭据为服务的终结点请求令牌。

语法

HRESULT GetEndpointToken(
  [in]  GUID                        serviceId,
  [in]  UpdateEndpointType          endpointType,
  [in]  UpdateEndpointProxySettings proxySettings,
  [in]  HANDLE_PTR                  hUserToken,
  [in]  UpdateEndpointAuthTokenType tokenType,
  [in]  BOOL                        fRefreshOnline,
  [out] IUnknown                    **ppEndpointToken
);

参数

ServiceId [in]

标识要更新的服务。

endpointType [in]

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

proxySettings [in]

连接到代理服务器时要使用的设置。 有关详细信息，请参阅 UpdateEndpointProxySettings 结构。

hUserToken [in]

tokenType [in]

标识用于身份验证的身份验证令牌类型。

fRefreshOnline [in]

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

ppEndpointToken [out]

指定要使用的终结点令牌。

返回值

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

注解

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

要求

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

另请参阅

IUpdateEndpointAuthProvider