NetworkOperatorTetheringManager.CreateFromConnectionProfile 方法

定义

命名空间:

Windows.Networking.NetworkOperators

重载

CreateFromConnectionProfile(ConnectionProfile)	使用给定配置文件作为公共接口，Wi-Fi 作为专用接口创建 NetworkOperatorTetheringManager 。
CreateFromConnectionProfile(ConnectionProfile, NetworkAdapter)	使用给定的配置文件作为公共接口，在给定的 NetworkAdapter 上作为专用接口创建 NetworkOperatorTetheringManager。

CreateFromConnectionProfile(ConnectionProfile)

使用给定配置文件作为公共接口，Wi-Fi 作为专用接口创建 NetworkOperatorTetheringManager 。

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 ，则清单未设置所需的设备功能。 请注意，即使返回 Enabled ，也应编写代码来处理错误和异常，因为系绳功能可能随时更改，不受应用的控制或通知。

另请参阅

• CreateFromConnectionProfile(ConnectionProfile, NetworkAdapter)

CreateFromConnectionProfile(ConnectionProfile, NetworkAdapter)

使用给定的配置文件作为公共接口，在给定的 NetworkAdapter 上作为专用接口创建 NetworkOperatorTetheringManager。

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 ，则清单未设置所需的设备功能。 请注意，即使返回 Enabled ，也应编写代码来处理错误和异常，因为系绳功能可能随时更改，不受应用的控制或通知。

另请参阅

• CreateFromConnectionProfile(ConnectionProfile)