WiFiOnDemandHotspotNetwork Clase

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.

Representa un dispositivo que admite el punto de acceso a petición. La aplicación registra ese dispositivo con el sistema operativo (SO), donde la aplicación puede habilitar de forma remota el punto de acceso móvil. Al actualizar las propiedades de este objeto, la aplicación puede señalar al sistema operativo para actualizar la interfaz de usuario (UI). El objeto se clave en un identificador único global (GUID) elegido por el autor de la llamada que está diseñado para identificar el dispositivo (la propiedad Id ).

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 ref class WiFiOnDemandHotspotNetwork sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 983040)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class WiFiOnDemandHotspotNetwork final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 983040)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class WiFiOnDemandHotspotNetwork

Public NotInheritable Class WiFiOnDemandHotspotNetwork

Herencia

Object Platform::Object IInspectable WiFiOnDemandHotspotNetwork

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos de Windows

Familia de dispositivos	Windows 11 Insider Preview (se introdujo en la versión 10.0.23504.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v15.0)
Características de aplicaciones	onDemandHotspotControl

Ejemplos

Ejemplo de zona activa a petición

Comentarios

El punto de acceso a petición es la característica de Windows que permite a un dispositivo cliente de Windows ver y habilitar de forma remota el punto de acceso móvil o el punto de acceso compartido a Internet en un dispositivo Windows host (ya sea un equipo o un teléfono) y conectarse a él. Esto permite al dispositivo cliente compartir la conexión a Internet del dispositivo host. Esta funcionalidad se expone al usuario insertando una red Wi-Fi en la lista de red del cliente cuando el usuario abre la configuración rápida de Wi-Fi o Wi-Fi redes disponibles (Windows 11).

La aplicación es responsable de determinar cómo comunicarse con el punto de acceso para obtener los metadatos, fuera de esta API.

Propiedades

Id

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. Identificador único global (GUID) elegido por el autor de la llamada que está diseñado para identificar el punto de acceso. 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.

Métodos

GetOrCreateById(Guid)	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.
GetProperties()	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. Recupera de un objeto WiFiOnDemandHotspotNetwork varias propiedades de la red de zona activa, como porcentaje de batería, nombre para mostrar, disponibilidad y SSID/contraseña. 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.
UpdateProperties(WiFiOnDemandHotspotNetworkProperties)	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. Establece en un objeto WiFiOnDemandHotspotNetwork varias propiedades de la red de zona activa, como porcentaje de batería, nombre para mostrar, disponibilidad y SSID/contraseña. Si alguna propiedad no es válida, UpdateProperties produce una excepción de argumento no válida. 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.

Consulte también

• <xref:%0a%0a-+%5bWiFiOnDemandHotspotUpdateMetadataTrigger%5d(%2fuwp%2fapi%2fwindows.applicationmodel.background.wifiondemandhotspotupdatemetadatatrigger)%0a-+%5bWiFiOnDemandHotspotConnectTrigger%5d(%2fuwp%2fapi%2fwindows.applicationmodel.background.wifiondemandhotspotconnecttrigger)>