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]

識別服務所實作的端點類型。

proxy 設定 [in]

連接到 Proxy 伺服器時要使用的設定。 如需詳細資訊，請參閱 UpdateEndpointProxy 設定 結構。

hUserToken [in]

tokenType [in]

識別用於驗證的驗證令牌類型。

fRefreshOnline [in]

表示天氣 WUA 要求新的令牌。 True 表示要求新的令牌。 False 表示要求新的或快取的令牌。 如需詳細資訊，請參閱。

ppEndpointToken [out]

指定要使用的端點令牌。

傳回值

如果成功，則傳回S_OK。 否則，會傳回 COM 或 Windows 錯誤碼。

備註

WUA 通常會在第一次呼叫此方法時，將 fRefreshOnline 參數設定為 false，則如果發生連接錯誤，當再次呼叫 方法時，WUA 會將該參數設定為 true。 不過，此方法的實作可以從安全性令牌服務 （STS） 要求新的令牌，或隨時提供快取的令牌。

需求

需求	值
最低支援的用戶端	Windows XP，Windows 2000 Professional with SP3 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003、Windows 2000 Server with SP3 [僅限傳統型應用程式]
頁首	UpdateEndpointAuth.h
IDL	UpdateEndpointAuth.idl
程式庫	UpdateEndpointAuth.lib
DLL	UpdateEndpointAuth.dll

另請參閱

IUpdateEndpointAuthProvider