Méthode IUpdateEndpointAuthProvider::GetEndpointToken

Article
12/14/2023

Demandez un jeton pour le point de terminaison du service à l’aide des informations d’identification spécifiées.

Syntaxe

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

Paramètres

serviceId [in]: Identifie le service à mettre à jour.
endpointType [in]: Identifie le type de point de terminaison implémenté par le service.
proxySettings [in]: Paramètres à utiliser lors de la connexion à un serveur proxy. Pour plus d’informations, consultez la structure UpdateEndpointProxy Paramètres.
hUserToken [in]
tokenType [in]: Identifie le type de jeton d’authentification utilisé pour l’authentification.
fRefreshOnline [in]: Indique si WUA demande un nouveau jeton. True indique qu’un nouveau jeton est demandé. False indique qu’un jeton nouveau ou mis en cache est demandé. Pour plus d’informations, consultez la section Remarques.
ppEndpointToken [out]: Spécifie le jeton de point de terminaison à utiliser.

Valeur retournée

HTTP 200 (OK) si l'opération a réussi. Sinon, retourne un code d’erreur COM ou Windows.

Notes

WUA définit généralement le paramètre fRefreshOnline sur False lorsque cette méthode est appelée pour la première fois. Ainsi, si une erreur de connexion se produit, WUA définit ce paramètre sur True lorsque la méthode est appelée à nouveau. Toutefois, l’implémentation de cette méthode peut demander un nouveau jeton à partir d’un service STS (service d'émission de jeton de sécurité) ou fournir un jeton mis en cache à tout moment.

Configuration requise

Condition requise	Value
Client minimal pris en charge	Windows XP, Windows 2000 Professionnel avec SP3 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003, Windows 2000 Server avec SP3 [applications de bureau uniquement]
En-tête	UpdateEndpointAuth.h
IDL	UpdateEndpointAuth.idl
Bibliothèque	UpdateEndpointAuth.lib
DLL	UpdateEndpointAuth.dll

Voir aussi

IUpdateEndpointAuthProvider

Partager via