HotspotAuthenticationContext.IssueCredentials Method

Definition

Namespace:

Windows.Networking.NetworkOperators

Provides credentials to Windows for hotspot authentication

Note

This functionality is available only to mobile operator apps and UWP apps given privileged access by mobile network operators.

If you want to use this API and publish your app to the Microsoft Store, then you'll need special approval. For more information, see the Restricted capabilities section in the App capability declarations topic.

Windows does not cache these credentials and another authentication event will be raised when the system connects to the same hotspot again.

public:
 virtual void IssueCredentials(Platform::String ^ userName, Platform::String ^ password, Platform::String ^ extraParameters, bool markAsManualConnectOnFailure) = IssueCredentials;

void IssueCredentials(winrt::hstring const& userName, winrt::hstring const& password, winrt::hstring const& extraParameters, bool const& markAsManualConnectOnFailure);

public void IssueCredentials(string userName, string password, string extraParameters, bool markAsManualConnectOnFailure);

function issueCredentials(userName, password, extraParameters, markAsManualConnectOnFailure)

Public Sub IssueCredentials (userName As String, password As String, extraParameters As String, markAsManualConnectOnFailure As Boolean)

Parameters

userName

String

Platform::String

winrt::hstring

The UserName parameter of the Wireless Internet Service Provider roaming (WISPr) authentication protocol. IssueCredentials performs URL encoding before submitting the value to the server. If this string is empty, the corresponding authentication parameter is skipped.

password

String

Platform::String

winrt::hstring

The Password parameter of the WISPr authentication protocol. IssueCredentials performs URL encoding before submitting the value to the server. If this string is empty, the corresponding authentication parameter is skipped.

extraParameters

String

Platform::String

winrt::hstring

Additional parameters to be appended to the authentication string. IssueCredentials appends this parameter after an "&" character to the HTTP POST string as is without any encoding. This can be used to add multiple parameters. The default for this parameter is an empty string.

markAsManualConnectOnFailure

Boolean

bool

If true, an application permanently disables the auto-connect property on a connection. If authentication fails, the connection will be disconnected and not retried in the current user session. Otherwise, false.

Windows requirements

App capabilities

cellularDeviceControl cellularDeviceIdentity

Remarks

Once IssueCredentials is called, the authentication context is finalized and IssueCredentials, AbortAuthentication, or SkipAuthentication should not be called again.