HotspotAuthenticationContext.IssueCredentialsAsync Método

Definición

Espacio de nombres:

Windows.Networking.NetworkOperators

Proporciona de forma asincrónica credenciales a Windows para la autenticación de zona activa Windows no almacena en caché estas credenciales y se generará otro evento de autenticación cuando el sistema se conecte a la misma zona activa de nuevo.

Es una versión asincrónica de IssueCredentials. Toma los mismos parámetros, pero la operación asincrónica solo se completa cuando se completa la autenticación. En cambio, la API IssueCredentials devuelve tan pronto como se inicia la autenticación. Al finalizar este método, se puede examinar el objeto de resultados para comprobar el estado del intento de autenticación.

Nota:

Esta funcionalidad solo está disponible para las aplicaciones de operadores móviles y las aplicaciones para UWP con acceso con privilegios por parte de los operadores de red móvil.

Si quieres usar esta API y publicar tu aplicación en Microsoft Store, necesitarás aprobación especial. Para obtener más información, consulte la sección Funcionalidades restringidas del tema Declaraciones de funcionalidad de la aplicación .

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)

Parámetros

userName

String

Platform::String

winrt::hstring

El parámetro UserName del protocolo de autenticación del proveedor de servicios inalámbricos de Internet (WISPr). IssueCredentials realiza la codificación de direcciones URL antes de enviar el valor al servidor. Si esta cadena está vacía, se omite el parámetro de autenticación correspondiente.

password

String

Platform::String

winrt::hstring

Parámetro Password del protocolo de autenticación WISPr. IssueCredentials realiza la codificación de direcciones URL antes de enviar el valor al servidor. Si esta cadena está vacía, se omite el parámetro de autenticación correspondiente.

extraParameters

String

Platform::String

winrt::hstring

Parámetros adicionales que se van a anexar a la cadena de autenticación. IssueCredentials anexa este parámetro después de un carácter "&" a la cadena HTTP POST tal cual sin ninguna codificación. Se puede usar para agregar varios parámetros. El valor predeterminado de este parámetro es una cadena vacía.

markAsManualConnectOnFailure

Boolean

bool

Si es true, una aplicación deshabilita permanentemente la propiedad de conexión automática en una conexión. Si se produce un error en la autenticación, la conexión se desconectará y no se volverá a intentar en la sesión de usuario actual. De lo contrario, se devuelve el valor False.

Devoluciones

IAsyncOperation<HotspotCredentialsAuthenticationResult>

Resultados de la solicitud de autenticación de Hotspot.

Atributos

RemoteAsyncAttribute

Requisitos de Windows

Características de aplicaciones

cellularDeviceControl cellularDeviceIdentity