HotspotAuthenticationContext.IssueCredentialsAsync 方法

定义

命名空间:

Windows.Networking.NetworkOperators

异步向 Windows 提供凭据以用于热点身份验证 Windows 不会缓存这些凭据，当系统再次连接到同一热点时，将引发另一个身份验证事件。

它是 IssueCredentials 的异步版本。 它采用相同的参数，但异步操作仅在身份验证完成时完成。 相比之下，在开始身份验证后， IssueCredentials API 会立即返回。 完成此方法后，可能会检查结果对象以检查身份验证尝试的状态。

注意

此功能仅适用于移动运营商应用和由移动网络运营商授予特权访问权限的 UWP 应用。

如果要使用此 API 并将应用发布到 Microsoft Store，则需要获得特殊批准。 有关详细信息，请参阅应用功能声明主题中的受限功能部分。

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)

参数

userName

String

Platform::String

winrt::hstring

无线 Internet 服务提供商漫游 (WISPr) 身份验证协议的 UserName 参数。 IssueCredentials 在将值提交到服务器之前执行 URL 编码。 如果此字符串为空，则跳过相应的身份验证参数。

password

String

Platform::String

winrt::hstring

WISPr 身份验证协议的 Password 参数。 IssueCredentials 在将值提交到服务器之前执行 URL 编码。 如果此字符串为空，则跳过相应的身份验证参数。

extraParameters

String

Platform::String

winrt::hstring

要追加到身份验证字符串的其他参数。 IssueCredentials 按原样将此参数追加到 HTTP POST 字符串的“&”字符后面，而不进行任何编码。 这可用于添加多个参数。 此参数的默认值为空字符串。

markAsManualConnectOnFailure

Boolean

bool

如果 为 true，应用程序将永久禁用连接上的自动连接属性。 如果身份验证失败，连接将断开连接，并且不会在当前用户会话中重试。 否则为 false。

返回

IAsyncOperation<HotspotCredentialsAuthenticationResult>

热点身份验证请求的结果。

属性

RemoteAsyncAttribute

Windows 要求

应用功能	cellularDeviceControl cellularDeviceIdentity