Поделиться через

WiFiOnDemandHotspotNetwork Класс

  • Ссылка

Определение

Пространство имен:
Windows.Devices.WiFi
Изменить

Примечание

Некоторые сведения относятся к предварительной версии продукта, в которую перед коммерческим выпуском могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Важно!

На этот API повлияют предстоящие изменения в поведении операционной системы, запланированные на осень 2024 г. Дополнительные сведения см. в статье Изменения в поведении API для Wi-Fi доступа и расположения.

Представляет устройство, поддерживающее хот-спот по запросу. Приложение регистрирует это устройство в операционной системе (ОС), где приложение может удаленно включить мобильный хот-спот. Обновляя свойства этого объекта, приложение может сообщить ОС об обновлении пользовательского интерфейса. Объект имеет ключ к выбранному вызывающей стороной глобальному уникальному идентификатору (GUID), который предназначен для идентификации устройства (свойство Id ).

Примечание

Если вы хотите использовать этот API в приложении UWP и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (возможность сети по запросу). Дополнительные сведения см. в разделе Пользовательские возможности.

Возможность сети по запросу будет доступна только разработчикам приложений, создающим комплексные сценарии Wi-Fi хот-спотов между аппаратным устройством с поддержкой привязки и компьютером с 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
Наследование
Object Platform::Object IInspectable WiFiOnDemandHotspotNetwork
Атрибуты
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Требования к Windows

Семейство устройств
Windows 11 Insider Preview (появилось в 10.0.23504.0)
API contract
Windows.Foundation.UniversalApiContract (появилось в v15.0)
Возможности приложения
onDemandHotspotControl

Примеры

Пример хот-спота по запросу

Комментарии

Хот-спот по запросу — это функция Windows, которая позволяет клиентскому устройству Windows просматривать и удаленно включать точку доступа для мобильного хот-спота или интернет-доступа на хост-устройстве Windows (пк или телефоне) и подключаться к нему. Это позволяет клиентскому устройству совместно использовать подключение к Интернету главного устройства. Эта функция предоставляется пользователю путем внедрения Wi-Fi сети в список сетей клиента, когда пользователь открывает Wi-Fi быстрые параметры или Wi-Fi доступные сети системных параметров (Windows 11).

Приложение отвечает за то, как взаимодействовать с хот-спотом для получения метаданных за пределами этого API.

Свойства

Id

Примечание

Некоторые сведения относятся к предварительной версии продукта, в которую перед коммерческим выпуском могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Важно!

На этот API повлияют предстоящие изменения в поведении операционной системы, запланированные на осень 2024 г. Дополнительные сведения см. в статье Изменения в поведении API для Wi-Fi доступа и расположения.

Выбранный вызывающей стороны глобальный уникальный идентификатор (GUID), предназначенный для идентификации хот-спота.

Примечание

Если вы хотите использовать этот API в приложении UWP и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (возможность сети по запросу). Дополнительные сведения см. в разделе Пользовательские возможности.

Возможность сети по запросу будет доступна только разработчикам приложений, создающим комплексные сценарии Wi-Fi хот-спотов между аппаратным устройством с поддержкой привязки и компьютером с Windows.

Методы

GetOrCreateById(Guid)

Примечание

Некоторые сведения относятся к предварительной версии продукта, в которую перед коммерческим выпуском могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Важно!

На этот API повлияют предстоящие изменения в поведении операционной системы, запланированные на осень 2024 г. Дополнительные сведения см. в статье Изменения в поведении API для Wi-Fi доступа и расположения.

Если операционная система (ОС) уже настроена с помощью хот-спота из вызывающего приложения, GetOrCreateById извлекает объект WiFiOnDemandHotspotNetwork , соответствующий заданному идентификатору networkId. В противном случае метод создает новую сеть для этого идентификатора.

Примечание

Если вы хотите использовать этот API в приложении UWP и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (возможность сети по запросу). Дополнительные сведения см. в разделе Пользовательские возможности.

Возможность сети по запросу будет доступна только разработчикам приложений, создающим комплексные сценарии Wi-Fi хот-спотов между аппаратным устройством с поддержкой привязки и компьютером с Windows.
GetProperties()

Примечание

Некоторые сведения относятся к предварительной версии продукта, в которую перед коммерческим выпуском могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Важно!

На этот API повлияют предстоящие изменения в поведении операционной системы, запланированные на осень 2024 г. Дополнительные сведения см. в статье Изменения в поведении API для Wi-Fi доступа и расположения.

Извлекает из объекта WiFiOnDemandHotspotNetwork различные свойства сети хот-спотов, такие как процент батареи, отображаемое имя, доступность и SSID/пароль.

Примечание

Если вы хотите использовать этот API в приложении UWP и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (возможность сети по запросу). Дополнительные сведения см. в разделе Пользовательские возможности.

Возможность сети по запросу будет доступна только разработчикам приложений, создающим комплексные сценарии Wi-Fi хот-спотов между аппаратным устройством с поддержкой привязки и компьютером с Windows.
UpdateProperties(WiFiOnDemandHotspotNetworkProperties)

Примечание

Некоторые сведения относятся к предварительной версии продукта, в которую перед коммерческим выпуском могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Важно!

На этот API повлияют предстоящие изменения в поведении операционной системы, запланированные на осень 2024 г. Дополнительные сведения см. в статье Изменения в поведении API для Wi-Fi доступа и расположения.

Задает для объекта WiFiOnDemandHotspotNetwork различные свойства сети хот-спотов, такие как процент батареи, отображаемое имя, доступность и SSID/пароль. Если какое-либо свойство является недопустимым, UpdateProperties создает исключение недопустимого аргумента.

Примечание

Если вы хотите использовать этот API в приложении UWP и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (возможность сети по запросу). Дополнительные сведения см. в разделе Пользовательские возможности.

Возможность сети по запросу будет доступна только разработчикам приложений, создающим комплексные сценарии Wi-Fi хот-спотов между аппаратным устройством с поддержкой привязки и компьютером с Windows.

Применяется к

См. также раздел

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