WiFiOnDemandHotspotNetwork.GetOrCreateById(Guid) Método

Definición

Espacio de nombres:

Windows.Devices.WiFi

Nota

Parte de la información hace referencia al producto de versión preliminar, el cual puede sufrir importantes modificaciones antes de que se publique la versión comercial. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Importante

Esta API se verá afectada por los próximos cambios en el comportamiento del sistema operativo, previsto para el otoño de 2024. Para obtener más información, consulte Cambios en el comportamiento de la API para Wi-Fi acceso y ubicación.

Si el sistema operativo (SO) ya está configurado con un punto de acceso desde la aplicación que realiza la llamada, GetOrCreateById recupera el objeto WiFiOnDemandHotspotNetwork correspondiente al networkId especificado. De lo contrario, el método crea una nueva red para ese identificador.

Nota

Si quieres usar esta API en una aplicación para UWP y publicar la aplicación en Microsoft Store, tendrás que solicitar una aprobación especial para usar la funcionalidad personalizada Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (la funcionalidad red a petición). Para obtener más información, consulta Funcionalidades personalizadas.

La funcionalidad Red a petición solo estará disponible para los desarrolladores de aplicaciones que crean escenarios de punto de acceso de un extremo a otro Wi-Fi entre un dispositivo de hardware compatible con tethering y un equipo Windows.

public:
 static WiFiOnDemandHotspotNetwork ^ GetOrCreateById(Platform::Guid networkId);

 static WiFiOnDemandHotspotNetwork GetOrCreateById(winrt::guid const& networkId);

public static WiFiOnDemandHotspotNetwork GetOrCreateById(Guid networkId);

function getOrCreateById(networkId)

Public Shared Function GetOrCreateById (networkId As Guid) As WiFiOnDemandHotspotNetwork

Parámetros

networkId

Guid

Platform::Guid

winrt::guid

Identificador único global (GUID) que identifica un objeto WiFiOnDemandHotspotNetwork .

Devoluciones

WiFiOnDemandHotspotNetwork

Objeto que se creó o recuperó.

Requisitos de Windows

Características de aplicaciones

onDemandHotspotControl

Comentarios

• El identificador puede ser cualquier valor que elija la aplicación para distinguir varios puntos de acceso a petición. Sin embargo, para obtener el mejor rendimiento con conexiones efímeras, se recomienda reutilizar el mismo identificador y actualizar el SSID y la contraseña en lugar de crear nuevas redes para cada una.
• El identificador solo debe ser único dentro de una aplicación.
• La aplicación que llama debe tener la identidad del paquete.