HotspotAuthenticationContext.IssueCredentials 方法

定义

命名空间:

Windows.Networking.NetworkOperators

向 Windows 提供用于热点身份验证的凭据

注意

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

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

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

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)

参数

userName

String

Platform::String

winrt::hstring

无线 Internet 服务提供商漫游的 UserName 参数 (WISPr) 身份验证协议。 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。

Windows 要求

应用功能	cellularDeviceControl cellularDeviceIdentity

注解

调用 IssueCredentials 后，身份验证上下文将完成，不应再次调用 IssueCredentials、 AbortAuthentication 或 SkipAuthentication 。