NetworkOperatorTetheringManager.CreateFromConnectionProfile Methode

Definition

Überlädt

CreateFromConnectionProfile(ConnectionProfile)

Erstellt einen NetworkOperatorTetheringManager unter Verwendung des angegebenen Profils als öffentliche Schnittstelle und Wi-Fi als private Schnittstelle.

CreateFromConnectionProfile(ConnectionProfile, NetworkAdapter)

Erstellt einen NetworkOperatorTetheringManager unter Verwendung des angegebenen Profils als öffentliche Schnittstelle und für den angegebenen NetworkAdapter als private Schnittstelle.

CreateFromConnectionProfile(ConnectionProfile)

Erstellt einen NetworkOperatorTetheringManager unter Verwendung des angegebenen Profils als öffentliche Schnittstelle und Wi-Fi als private Schnittstelle.

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

Parameter

profile
ConnectionProfile

Zu verwendende Verbindungsprofil.

Gibt zurück

Das resultierende Managerobjekt.

Attribute

Windows-Anforderungen

App-Funktionen
wiFiControl

Hinweise

In früheren Releases konnten nur privilegierte Apps von Netzbetreibern ein NetworkOperatorTetheringManager-Objekt erstellen und zum Steuern des Tetherings verwenden. In diesem Release kann jede App das Objekt erstellen, indem CreateFromConnectionProfile aufgerufen wird. Damit der Aufruf erfolgreich ist, muss die App jedoch die entsprechende Wi-Fi Steuerungsgerätefunktion im Manifest deklariert haben. Das folgende Beispiel zeigt einen Teil eines Manifests mit dem erforderlichen DeviceCapability-Tag mit dem wiFiControl-Attribut .

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

Wenn die wiFiControl-Gerätefunktion im Manifest nicht festgelegt ist, schlagen Aufrufe von CreateFromConnectionProfile fehl, indem eine Ausnahme ausgelöst wird.

Ihr Code kann bestimmen, ob die Funktion zur Laufzeit festgelegt ist, indem Sie GetTetheringCapabilityFromConnectionProfile aufrufen. Wenn DisabledBySystemCapability zurückgegeben wird, legt das Manifest die erforderliche Gerätefunktion nicht fest. Beachten Sie, dass Ihr Code auch dann geschrieben werden sollte, wenn Aktiviert zurückgegeben wird, um Fehler und Ausnahmen zu behandeln, da sich die Tetheringfunktion jederzeit ändern kann, außerhalb der Kontrolle oder Benachrichtigung Ihrer App.

Weitere Informationen

Gilt für:

CreateFromConnectionProfile(ConnectionProfile, NetworkAdapter)

Erstellt einen NetworkOperatorTetheringManager unter Verwendung des angegebenen Profils als öffentliche Schnittstelle und für den angegebenen NetworkAdapter als private Schnittstelle.

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

Parameter

profile
ConnectionProfile

Zu verwendende Verbindungsprofil.

adapter
NetworkAdapter

Der Netzwerkadapter, auf dem die Verbindung freigegeben wird. Die freigegebene Verbindung wird vom NetworkOperatorTetheringManager gesteuert.

Gibt zurück

Das resultierende Managerobjekt.

Attribute

Windows-Anforderungen

Gerätefamilie
Windows 10 Anniversary Edition (eingeführt in 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v3.0)
App-Funktionen
wiFiControl

Hinweise

In früheren Releases konnten nur privilegierte Apps von Netzbetreibern ein NetworkOperatorTetheringManager-Objekt erstellen und zum Steuern des Tetherings verwenden. In diesem Release kann jede App das Objekt erstellen, indem CreateFromConnectionProfile aufgerufen wird. Damit der Aufruf erfolgreich ist, muss die App jedoch die entsprechende Wi-Fi Steuerungsgerätefunktion im Manifest deklariert haben. Das folgende Beispiel zeigt einen Teil eines Manifests mit dem erforderlichen DeviceCapability-Tag mit dem wiFiControl-Attribut .

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

Wenn die wiFiControl-Gerätefunktion im Manifest nicht festgelegt ist, schlagen Aufrufe von CreateFromConnectionProfile fehl, indem eine Ausnahme ausgelöst wird.

Ihr Code kann bestimmen, ob die Funktion zur Laufzeit festgelegt ist, indem Sie GetTetheringCapabilityFromConnectionProfile aufrufen. Wenn DisabledBySystemCapability zurückgegeben wird, legt das Manifest die erforderliche Gerätefunktion nicht fest. Beachten Sie, dass Ihr Code auch dann geschrieben werden sollte, wenn Aktiviert zurückgegeben wird, um Fehler und Ausnahmen zu behandeln, da sich die Tetheringfunktion jederzeit ändern kann, außerhalb der Kontrolle oder Benachrichtigung Ihrer App.

Weitere Informationen

Gilt für: