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

WiFiOnDemandHotspotNetwork.GetOrCreateById(Guid) Метод

  • Ссылка

Определение

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

Примечание

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

Важно!

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

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

Примечание

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

Возможность сети по запросу будет доступна только разработчикам приложений, создающим комплексные сценарии Wi-Fi хот-спотов между аппаратным устройством с поддержкой привязки и компьютером с 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

Параметры

networkId
Guid

Platform::Guid

winrt::guid

Глобальный уникальный идентификатор (GUID), определяющий объект WiFiOnDemandHotspotNetwork .

Возвращаемое значение

WiFiOnDemandHotspotNetwork

Объект, который был создан или получен.

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

Возможности приложения
onDemandHotspotControl

Комментарии

  • Идентификатор может быть любым значением, которое приложение выбирает для различения нескольких хот-спотов по запросу. Однако для обеспечения оптимальной производительности при эфемерных подключениях рекомендуется повторно использовать один и тот же идентификатор и обновить идентификатор SSID и Пароль вместо создания новых сетей для каждой из них.
  • Идентификатор должен быть уникальным только в пределах приложения.
  • Вызывающее приложение должно иметь удостоверение пакета.

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