HotspotAuthenticationContext.IssueCredentialsAsync Méthode

Référence

Définition

Espace de noms:: Windows.Networking.NetworkOperators

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.

Modifier

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.