NetworkOperatorTetheringManager.CreateFromConnectionProfile Метод

Определение

Пространство имен:

Windows.Networking.NetworkOperators

Перегрузки

CreateFromConnectionProfile(ConnectionProfile)	Создает NetworkOperatorTetheringManager , используя заданный профиль в качестве общедоступного интерфейса и Wi-Fi в качестве частного интерфейса.
CreateFromConnectionProfile(ConnectionProfile, NetworkAdapter)	Создает NetworkOperatorTetheringManager , используя заданный профиль в качестве общедоступного интерфейса, а для заданного NetworkAdapter — в качестве частного интерфейса.

CreateFromConnectionProfile(ConnectionProfile)

Создает NetworkOperatorTetheringManager , используя заданный профиль в качестве общедоступного интерфейса и Wi-Fi в качестве частного интерфейса.

public:
 static NetworkOperatorTetheringManager ^ CreateFromConnectionProfile(ConnectionProfile ^ profile);

/// [Windows.Foundation.Metadata.Overload("CreateFromConnectionProfile")]
 static NetworkOperatorTetheringManager CreateFromConnectionProfile(ConnectionProfile const& 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

Используемый профиль подключения.

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

NetworkOperatorTetheringManager

Результирующий объект диспетчера.

Атрибуты

OverloadAttribute

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

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

wiFiControl

Комментарии

В предыдущих выпусках только привилегированные приложения от сетевых операторов могли создавать объект NetworkOperatorTetheringManager и использовать его для управления привязкой. В этом выпуске любое приложение может создать объект , вызвав Метод CreateFromConnectionProfile. Однако для успешного вызова приложение должно иметь соответствующую возможность управления устройством Wi-Fi, объявленной в своем манифесте. В следующем примере показана часть манифеста с необходимым тегом DeviceCapability с атрибутом wiFiControl .

<Capabilities>
  <DeviceCapability Name="wiFiControl"/>
</Capabilities>

Если возможность устройства wiFiControl не задана в манифесте, вызовы CreateFromConnectionProfile завершаются ошибкой, вызывая исключение.

Код может определить, задана ли возможность во время выполнения, вызвав Метод GetTetheringCapabilityFromConnectionProfile. Если возвращается значение DisabledBySystemCapability , манифест не задает требуемую возможность устройства. Обратите внимание, что даже если возвращается значение Включено , код должен быть написан для обработки ошибок и исключений, так как возможность привязки может измениться в любое время, вне контроля или уведомления вашего приложения.

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

• CreateFromConnectionProfile(ConnectionProfile, NetworkAdapter)

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.

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

NetworkOperatorTetheringManager

Результирующий объект диспетчера.

Атрибуты

OverloadAttribute

Требования к 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 , манифест не задает требуемую возможность устройства. Обратите внимание, что даже если возвращается значение Включено , код должен быть написан для обработки ошибок и исключений, так как возможность привязки может измениться в любое время, вне контроля или уведомления вашего приложения.

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

• CreateFromConnectionProfile(ConnectionProfile)