IUpdateEndpointAuthProvider::GetEndpointToken method

Artikel
12/18/2023

Anfordern eines Tokens für den Endpunkt des Diensts mithilfe der angegebenen Anmeldeinformationen

Syntax

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

Parameter

serviceId [in]: Identifiziert den Dienst, der aktualisiert werden soll.
endpointType [in]: Identifiziert den vom Dienst implementierten Endpunkttyp.
proxySettings [in]: Die Einstellungen, die beim Herstellen einer Verbindung mit einem Proxyserver verwendet werden sollen. Ausführlichere Informationen finden Sie in der UpdateEndpointProxySettings-Struktur.
hUserToken [in]
tokenType [in]: Identifiziert den Typ des Authentifizierungstokens, das für die Authentifizierung verwendet wird.
fRefreshOnline [in]: Gibt an, ob WUA ein neues Token anfordert. „True“ gibt an, dass ein neues Token angefordert wird. „False“ gibt an, dass ein neues oder zwischengespeichertes Token angefordert wird. Weitere Informationen finden Sie unter Hinweise.
ppEndpointToken [out]: Gibt das zu verwendende Endpunkttoken an.

Rückgabewert

Gibt bei Erfolg „S_OK“ zurück. Andernfalls wird ein COM- oder Windows-Fehlercode zurückgegeben.

Hinweise

WUA legt den Parameter“fRefreshOnline“ in der Regel auf „false“ fest, wenn diese Methode zum ersten Mal aufgerufen wird. Wenn ein Verbindungsfehler auftritt, legt WUA diesen Parameter auf „true“ fest, wenn die Methode erneut aufgerufen wird. Die Implementierung dieser Methode kann jedoch jederzeit ein neues Token von einem Sicherheitstokendienst (Security Token Service, STS) anfordern oder ein zwischengespeichertes Token bereitstellen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional mit SP3 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003, Windows 2000 Server mit SP3 [nur Desktop-Apps]
Header	UpdateEndpointAuth.h
IDL	UpdateEndpointAuth.idl
Bibliothek	UpdateEndpointAuth.lib
DLL	UpdateEndpointAuth.dll

Siehe auch

IUpdateEndpointAuthProvider

Freigeben über