HotspotAuthenticationContext.IssueCredentialsAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Fournit de manière asynchrone des informations d’identification à Windows pour l’authentification du point d’accès Windows ne met pas en cache ces informations d’identification et un autre événement d’authentification est déclenché lorsque le système se connecte à nouveau au même point d’accès.
Il s’agit d’une version asynchrone de IssueCredentials. Elle prend les mêmes paramètres, mais l’opération asynchrone ne se termine qu’une fois l’authentification terminée. En revanche, l’API IssueCredentials retourne dès que l’authentification est démarrée. Une fois cette méthode terminée, l’objet de résultats peut être examiné pour case activée la status de la tentative d’authentification.
Notes
Cette fonctionnalité n’est disponible que pour les applications d’opérateur mobile et les applications UWP disposant d’un accès privilégié par les opérateurs de réseau mobile.
Si vous souhaitez utiliser cette API et publier votre application dans le Microsoft Store, vous aurez besoin d’une approbation spéciale. Pour plus d’informations, consultez la section Fonctionnalités restreintes dans la rubrique Déclarations de fonctionnalités d’application .
public:
virtual IAsyncOperation<HotspotCredentialsAuthenticationResult ^> ^ IssueCredentialsAsync(Platform::String ^ userName, Platform::String ^ password, Platform::String ^ extraParameters, bool markAsManualConnectOnFailure) = IssueCredentialsAsync;/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<HotspotCredentialsAuthenticationResult> IssueCredentialsAsync(winrt::hstring const& userName, winrt::hstring const& password, winrt::hstring const& extraParameters, bool const& markAsManualConnectOnFailure);[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<HotspotCredentialsAuthenticationResult> IssueCredentialsAsync(string userName, string password, string extraParameters, bool markAsManualConnectOnFailure);function issueCredentialsAsync(userName, password, extraParameters, markAsManualConnectOnFailure)Public Function IssueCredentialsAsync (userName As String, password As String, extraParameters As String, markAsManualConnectOnFailure As Boolean) As IAsyncOperation(Of HotspotCredentialsAuthenticationResult)Paramètres
- userName
-
String
Platform::String
winrt::hstring
Paramètre UserName du protocole d’authentification itinérante WISPr (Wireless Internet Service Provider). IssueCredentials effectue l’encodage d’URL avant d’envoyer la valeur au serveur. Si cette chaîne est vide, le paramètre d’authentification correspondant est ignoré.
- password
-
String
Platform::String
winrt::hstring
Paramètre Password du protocole d’authentification WISPr. IssueCredentials effectue l’encodage d’URL avant d’envoyer la valeur au serveur. Si cette chaîne est vide, le paramètre d’authentification correspondant est ignoré.
- extraParameters
-
String
Platform::String
winrt::hstring
Paramètres supplémentaires à ajouter à la chaîne d’authentification. IssueCredentials ajoute ce paramètre après un caractère « & » à la chaîne HTTP POST telle quelle sans encodage. Vous pouvez l’utiliser pour ajouter plusieurs paramètres. La valeur par défaut de ce paramètre est une chaîne vide.
- markAsManualConnectOnFailure
-
Boolean
bool
Si la valeur est true, une application désactive définitivement la propriété de connexion automatique sur une connexion. Si l’authentification échoue, la connexion est déconnectée et n’est pas retentée dans la session utilisateur actuelle. Dans le cas contraire, la valeur est false.
Retours
Résultats de la demande d’authentification Hotspot.
- Attributs
Configuration requise pour Windows
| Fonctionnalités de l’application |
cellularDeviceControl
cellularDeviceIdentity
|