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 ，您的程式碼也應該撰寫來處理錯誤和例外狀況，因為系結功能可以隨時在應用程式的控制項或通知之外變更。