Méthode IWebAuthenticationCoreManagerInterop ::RequestTokenWithWebAccountForWindowAsync (webauthenticationcoremanagerinterop.h)

Article
03/03/2024

Demande de façon asynchrone un jeton à un fournisseur de compte web. Si nécessaire, l’utilisateur est invité à entrer ses informations d’identification.

Syntaxe

HRESULT RequestTokenWithWebAccountForWindowAsync(
  HWND         appWindow,
  IInspectable *request,
  IInspectable *webAccount,
  REFIID       riid,
  void         **asyncInfo
);

Paramètres

appWindow

Type : HWND

Fenêtre à utiliser en tant que propriétaire de la fenêtre invitant l’utilisateur à entrer des informations d’identification, au cas où une telle fenêtre deviendrait nécessaire.

request

Type : IInspectable*

La demande de jeton web, donnée en tant que instance de la classe WebTokenRequest de type casté vers l’interface IInspectable.

webAccount

Type : IInspectable*

Le compte web de la demande, donné sous la forme d’un instance de la classe WebAccount de type casté vers l’interface IInspectable.

riid

Type : REFIID

Doit faire référence à l’identificateur d’interface (IID) pour l’interface IAsyncOperation<WebTokenRequestResult>.

Cet IID est généré automatiquement et vous pouvez l’obtenir à l’aide du code suivant :

using winrt::Windows::Foundation::IAsyncOperation;
using winrt::Windows::Security::Authentication::Web::Core::WebTokenRequestResult;

constexpr winrt::guid iidAsyncRequestResult{ winrt::guid_of<IAsyncOperation<WebTokenRequestResult>>() };

asyncInfo

Type : void**

Adresse d’un pointeur vers IAsyncOperation<WebTokenRequestResult>. En cas de retour réussi de cette méthode, le pointeur est défini sur l’objet d’opération de requête asynchrone pour l’opération de requête qui vient de démarrer.

Valeur retournée

Type : HRESULT

Une status code pour la tentative de démarrage de l’opération de requête asynchrone.

Remarques

Cette méthode est l’équivalent pour les applications de bureau de WebAuthenticationCoreManager.RequestTokenAsync(WebTokenRequest, WebAccount).

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10 Build 20348
Serveur minimal pris en charge	Windows 10 Build 20348
En-tête	webauthenticationcoremanagerinterop.h

Partager via