NetworkOperatorTetheringManager.CreateFromConnectionProfile 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
重载
| CreateFromConnectionProfile(ConnectionProfile) |
使用给定配置文件作为公共接口，Wi-Fi 作为专用接口创建 NetworkOperatorTetheringManager 。 |
| CreateFromConnectionProfile(ConnectionProfile, NetworkAdapter) |
使用给定的配置文件作为公共接口，在给定的 NetworkAdapter 上作为专用接口创建 NetworkOperatorTetheringManager。 |
CreateFromConnectionProfile(ConnectionProfile)
使用给定配置文件作为公共接口，Wi-Fi 作为专用接口创建 NetworkOperatorTetheringManager 。
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 ，则清单未设置所需的设备功能。 请注意，即使返回 Enabled ，也应编写代码来处理错误和异常，因为系绳功能可能随时更改，不受应用的控制或通知。
另请参阅
适用于
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 控制。
返回
生成的管理器对象。
- 属性
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 ，也应编写代码来处理错误和异常，因为系绳功能可能随时更改，不受应用的控制或通知。