HotspotAuthenticationContext.IssueCredentialsAsync 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
异步向 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。
返回
热点身份验证请求的结果。
- 属性
Windows 要求
| 应用功能 |
cellularDeviceControl
cellularDeviceIdentity
|