NetworkOperatorTetheringManager.CreateFromConnectionProfile Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
| CreateFromConnectionProfile(ConnectionProfile) |
Создает NetworkOperatorTetheringManager , используя заданный профиль в качестве общедоступного интерфейса и Wi-Fi в качестве частного интерфейса. |
| CreateFromConnectionProfile(ConnectionProfile, NetworkAdapter) |
Создает NetworkOperatorTetheringManager , используя заданный профиль в качестве общедоступного интерфейса, а для заданного NetworkAdapter — в качестве частного интерфейса. |
CreateFromConnectionProfile(ConnectionProfile)
Создает NetworkOperatorTetheringManager , используя заданный профиль в качестве общедоступного интерфейса и Wi-Fi в качестве частного интерфейса.
public:
static NetworkOperatorTetheringManager ^ CreateFromConnectionProfile(ConnectionProfile ^ profile); static NetworkOperatorTetheringManager CreateFromConnectionProfile(ConnectionProfile const& profile);/// [Windows.Foundation.Metadata.Overload("CreateFromConnectionProfile")]
static NetworkOperatorTetheringManager CreateFromConnectionProfile(ConnectionProfile const& profile);public static NetworkOperatorTetheringManager CreateFromConnectionProfile(ConnectionProfile profile);[Windows.Foundation.Metadata.Overload("CreateFromConnectionProfile")]
public static NetworkOperatorTetheringManager CreateFromConnectionProfile(ConnectionProfile profile);function createFromConnectionProfile(profile)Public Shared Function CreateFromConnectionProfile (profile As ConnectionProfile) As NetworkOperatorTetheringManagerПараметры
- profile
- ConnectionProfile
Используемый профиль подключения.
Возвращаемое значение
Результирующий объект диспетчера.
- Атрибуты
Требования к Windows
| Возможности приложения |
wiFiControl
|
Комментарии
В предыдущих выпусках только привилегированные приложения от сетевых операторов могли создавать объект NetworkOperatorTetheringManager и использовать его для управления привязкой. В этом выпуске любое приложение может создать объект , вызвав Метод CreateFromConnectionProfile. Однако для успешного вызова приложение должно иметь соответствующую возможность управления устройством Wi-Fi, объявленной в своем манифесте. В следующем примере показана часть манифеста с необходимым тегом DeviceCapability с атрибутом wiFiControl .
<Capabilities>
<DeviceCapability Name="wiFiControl"/>
</Capabilities>
Если возможность устройства wiFiControl не задана в манифесте, вызовы CreateFromConnectionProfile завершаются ошибкой, вызывая исключение.
Код может определить, задана ли возможность во время выполнения, вызвав Метод GetTetheringCapabilityFromConnectionProfile. Если возвращается значение DisabledBySystemCapability , манифест не задает требуемую возможность устройства. Обратите внимание, что даже если возвращается значение Включено , код должен быть написан для обработки ошибок и исключений, так как возможность привязки может измениться в любое время, вне контроля или уведомления вашего приложения.
См. также раздел
Применяется к
CreateFromConnectionProfile(ConnectionProfile, NetworkAdapter)
Создает NetworkOperatorTetheringManager , используя заданный профиль в качестве общедоступного интерфейса, а для заданного NetworkAdapter — в качестве частного интерфейса.
public:
static NetworkOperatorTetheringManager ^ CreateFromConnectionProfile(ConnectionProfile ^ profile, NetworkAdapter ^ adapter);/// [Windows.Foundation.Metadata.Overload("CreateFromConnectionProfileWithTargetAdapter")]
static NetworkOperatorTetheringManager CreateFromConnectionProfile(ConnectionProfile const& profile, NetworkAdapter const& adapter);[Windows.Foundation.Metadata.Overload("CreateFromConnectionProfileWithTargetAdapter")]
public static NetworkOperatorTetheringManager CreateFromConnectionProfile(ConnectionProfile profile, NetworkAdapter adapter);function createFromConnectionProfile(profile, adapter)Public Shared Function CreateFromConnectionProfile (profile As ConnectionProfile, adapter As NetworkAdapter) As NetworkOperatorTetheringManagerПараметры
- profile
- ConnectionProfile
Используемый профиль подключения.
- adapter
- NetworkAdapter
Сетевой адаптер, к которому используется общее подключение. Общим подключением будет управлять NetworkOperatorTetheringManager.
Возвращаемое значение
Результирующий объект диспетчера.
- Атрибуты
Требования к Windows
| Семейство устройств |
Windows 10 Anniversary Edition (появилось в 10.0.14393.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (появилось в v3.0)
|
| Возможности приложения |
wiFiControl
|
Комментарии
В предыдущих выпусках только привилегированные приложения от сетевых операторов могли создавать объект NetworkOperatorTetheringManager и использовать его для управления привязкой. В этом выпуске любое приложение может создать объект , вызвав Метод CreateFromConnectionProfile. Однако для успешного вызова приложение должно иметь соответствующую возможность управления устройством Wi-Fi, объявленной в своем манифесте. В следующем примере показана часть манифеста с необходимым тегом DeviceCapability с атрибутом wiFiControl .
<Capabilities>
<DeviceCapability Name="wiFiControl"/>
</Capabilities>
Если возможность устройства wiFiControl не задана в манифесте, вызовы CreateFromConnectionProfile завершаются ошибкой, вызывая исключение.
Код может определить, задана ли возможность во время выполнения, вызвав Метод GetTetheringCapabilityFromConnectionProfile. Если возвращается значение DisabledBySystemCapability , манифест не задает требуемую возможность устройства. Обратите внимание, что даже если возвращается значение Включено , код должен быть написан для обработки ошибок и исключений, так как возможность привязки может измениться в любое время, вне контроля или уведомления вашего приложения.