NetworkOperatorTetheringManager.CreateFromConnectionProfile Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
| CreateFromConnectionProfile(ConnectionProfile) |
Crée un NetworkOperatorTetheringManager en utilisant le profil donné comme interface publique et Wi-Fi en tant qu’interface privée. |
| CreateFromConnectionProfile(ConnectionProfile, NetworkAdapter) |
Crée un NetworkOperatorTetheringManager en utilisant le profil donné comme interface publique et sur le NetworkAdapter donné en tant qu’interface privée. |
CreateFromConnectionProfile(ConnectionProfile)
Crée un NetworkOperatorTetheringManager en utilisant le profil donné comme interface publique et Wi-Fi en tant qu’interface privée.
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 NetworkOperatorTetheringManagerParamètres
- profile
- ConnectionProfile
Profil de connexion à utiliser.
Retours
Objet de gestionnaire résultant.
- Attributs
Configuration requise pour Windows
| Fonctionnalités de l’application |
wiFiControl
|
Remarques
Dans les versions précédentes, seules les applications privilégiées d’opérateurs réseau pouvaient créer un objet NetworkOperatorTetheringManager et l’utiliser pour contrôler la liaison. Dans cette version, n’importe quelle application peut créer l’objet en appelant CreateFromConnectionProfile. Toutefois, pour que l’appel réussisse, l’application doit disposer de la fonctionnalité de contrôle de l’appareil Wi-Fi appropriée déclarée dans son manifeste. L’exemple suivant montre une partie d’un manifeste avec la balise DeviceCapability nécessaire, avec l’attribut wiFiControl .
<Capabilities>
<DeviceCapability Name="wiFiControl"/>
</Capabilities>
Si la fonctionnalité d’appareil wiFiControl n’est pas définie dans le manifeste, les appels à CreateFromConnectionProfile échouent en lisant une exception.
Votre code peut déterminer si la fonctionnalité est définie au moment de l’exécution en appelant GetTetheringCapabilityFromConnectionProfile. Si DisabledBySystemCapability est retourné, le manifeste ne définit pas la fonctionnalité d’appareil requise. Notez que même si Activé est retourné, votre code doit être écrit pour gérer les erreurs et les exceptions, car la fonctionnalité de connexion peut changer à tout moment, en dehors du contrôle ou de la notification de votre application.
Voir aussi
S’applique à
CreateFromConnectionProfile(ConnectionProfile, NetworkAdapter)
Crée un NetworkOperatorTetheringManager en utilisant le profil donné comme interface publique et sur le NetworkAdapter donné en tant qu’interface privée.
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 NetworkOperatorTetheringManagerParamètres
- profile
- ConnectionProfile
Profil de connexion à utiliser.
- adapter
- NetworkAdapter
Carte réseau dans laquelle la connexion est partagée. La connexion partagée est contrôlée par NetworkOperatorTetheringManager.
Retours
Objet de gestionnaire résultant.
- Attributs
Configuration requise pour Windows
| Famille d’appareils |
Windows 10 Anniversary Edition (introduit dans 10.0.14393.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduit dans v3.0)
|
| Fonctionnalités de l’application |
wiFiControl
|
Remarques
Dans les versions précédentes, seules les applications privilégiées d’opérateurs réseau pouvaient créer un objet NetworkOperatorTetheringManager et l’utiliser pour contrôler la liaison. Dans cette version, n’importe quelle application peut créer l’objet en appelant CreateFromConnectionProfile. Toutefois, pour que l’appel réussisse, l’application doit disposer de la fonctionnalité de contrôle de l’appareil Wi-Fi appropriée déclarée dans son manifeste. L’exemple suivant montre une partie d’un manifeste avec la balise DeviceCapability nécessaire, avec l’attribut wiFiControl .
<Capabilities>
<DeviceCapability Name="wiFiControl"/>
</Capabilities>
Si la fonctionnalité d’appareil wiFiControl n’est pas définie dans le manifeste, les appels à CreateFromConnectionProfile échouent en lisant une exception.
Votre code peut déterminer si la fonctionnalité est définie au moment de l’exécution en appelant GetTetheringCapabilityFromConnectionProfile. Si DisabledBySystemCapability est retourné, le manifeste ne définit pas la fonctionnalité d’appareil requise. Notez que même si Activé est retourné, votre code doit être écrit pour gérer les erreurs et les exceptions, car la fonctionnalité de connexion peut changer à tout moment, en dehors du contrôle ou de la notification de votre application.