WiFiOnDemandHotspotNetwork Classe

Définition

Notes

Certaines informations portent sur la préversion du produit, qui est susceptible d’être en grande partie modifié avant sa commercialisation. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Important

Cette API sera affectée par les modifications à venir du comportement du système d’exploitation, prévues pour l’automne 2024. Pour plus d’informations, consultez Modifications du comportement de l’API pour l’accès Wi-Fi et l’emplacement.

Représente un appareil qui prend en charge le point d’accès à la demande. L’application inscrit cet appareil auprès du système d’exploitation, où l’application peut activer à distance le point d’accès mobile. En mettant à jour les propriétés de cet objet, l’application peut signaler au système d’exploitation la mise à jour de l’interface utilisateur. L’objet est clé sur un identificateur global unique (GUID) choisi par l’appelant qui est destiné à identifier l’appareil (propriété Id ).

Notes

Si vous souhaitez utiliser cette API dans une application UWP et publier votre application sur le Microsoft Store, vous devez demander une approbation spéciale pour utiliser la fonctionnalité personnalisée Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (fonctionnalité réseau à la demande). Pour plus d’informations, consultez Fonctionnalités personnalisées.

La fonctionnalité de réseau à la demande sera mise à la disposition uniquement des développeurs d’applications qui créent des scénarios de Wi-Fi de bout en bout entre un appareil matériel compatible avec connexion et un PC Windows.

public ref class WiFiOnDemandHotspotNetwork sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 983040)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class WiFiOnDemandHotspotNetwork final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 983040)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class WiFiOnDemandHotspotNetwork
Public NotInheritable Class WiFiOnDemandHotspotNetwork
Héritage
Object Platform::Object IInspectable WiFiOnDemandHotspotNetwork
Attributs

Configuration requise pour Windows

Famille d’appareils
Windows 11 Insider Preview (introduit dans 10.0.23504.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v15.0)
Fonctionnalités de l’application
onDemandHotspotControl

Exemples

Exemple de point d’accès à la demande

Remarques

Le point d’accès à la demande est la fonctionnalité de Windows qui permet à un appareil client Windows d’afficher et d’activer à distance le point d’accès mobile/Internet sur un appareil Windows hôte (pc ou téléphone) et de s’y connecter. Cela permet à l’appareil client de partager la connexion Internet de l’appareil hôte. Cette fonctionnalité est exposée à l’utilisateur en injectant un réseau Wi-Fi dans la liste des réseaux du client lorsque l’utilisateur ouvre le Wi-Fi Paramètres rapides ou Wi-Fi réseaux disponibles paramètres système (Windows 11).

L’application est chargée de déterminer comment communiquer avec le point d’accès pour obtenir les métadonnées, en dehors de cette API.

Propriétés

Id

Notes

Certaines informations portent sur la préversion du produit, qui est susceptible d’être en grande partie modifié avant sa commercialisation. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Important

Cette API sera affectée par les modifications à venir du comportement du système d’exploitation, prévues pour l’automne 2024. Pour plus d’informations, consultez Modifications du comportement de l’API pour l’accès Wi-Fi et l’emplacement.

Identificateur global unique (GUID) choisi par l’appelant destiné à identifier le point d’accès.

Notes

Si vous souhaitez utiliser cette API dans une application UWP et publier votre application sur le Microsoft Store, vous devez demander une approbation spéciale pour utiliser la fonctionnalité personnalisée Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (fonctionnalité réseau à la demande). Pour plus d’informations, consultez Fonctionnalités personnalisées.

La fonctionnalité de réseau à la demande sera mise à la disposition uniquement des développeurs d’applications qui créent des scénarios de Wi-Fi de bout en bout entre un appareil matériel compatible avec connexion et un PC Windows.

Méthodes

GetOrCreateById(Guid)

Notes

Certaines informations portent sur la préversion du produit, qui est susceptible d’être en grande partie modifié avant sa commercialisation. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Important

Cette API sera affectée par les modifications à venir du comportement du système d’exploitation, prévues pour l’automne 2024. Pour plus d’informations, consultez Modifications du comportement de l’API pour l’accès Wi-Fi et l’emplacement.

Si le système d’exploitation est déjà configuré avec un point d’accès à partir de l’application appelante, GetOrCreateById récupère l’objet WiFiOnDemandHotspotNetwork qui correspond au networkId donné. Sinon, la méthode crée un réseau pour cet ID.

Notes

Si vous souhaitez utiliser cette API dans une application UWP et publier votre application sur le Microsoft Store, vous devez demander une approbation spéciale pour utiliser la fonctionnalité personnalisée Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (fonctionnalité réseau à la demande). Pour plus d’informations, consultez Fonctionnalités personnalisées.

La fonctionnalité de réseau à la demande sera mise à la disposition uniquement des développeurs d’applications qui créent des scénarios de Wi-Fi de bout en bout entre un appareil matériel compatible avec connexion et un PC Windows.

GetProperties()

Notes

Certaines informations portent sur la préversion du produit, qui est susceptible d’être en grande partie modifié avant sa commercialisation. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Important

Cette API sera affectée par les modifications à venir du comportement du système d’exploitation, prévues pour l’automne 2024. Pour plus d’informations, consultez Modifications du comportement de l’API pour l’accès Wi-Fi et l’emplacement.

Récupère à partir d’un objet WiFiOnDemandHotspotNetwork différentes propriétés du réseau de points d’accès, telles que le pourcentage de batterie, le nom d’affichage, la disponibilité et le SSID/mot de passe.

Notes

Si vous souhaitez utiliser cette API dans une application UWP et publier votre application sur le Microsoft Store, vous devez demander une approbation spéciale pour utiliser la fonctionnalité personnalisée Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (fonctionnalité réseau à la demande). Pour plus d’informations, consultez Fonctionnalités personnalisées.

La fonctionnalité de réseau à la demande sera mise à la disposition uniquement des développeurs d’applications qui créent des scénarios de Wi-Fi de bout en bout entre un appareil matériel compatible avec connexion et un PC Windows.

UpdateProperties(WiFiOnDemandHotspotNetworkProperties)

Notes

Certaines informations portent sur la préversion du produit, qui est susceptible d’être en grande partie modifié avant sa commercialisation. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Important

Cette API sera affectée par les modifications à venir du comportement du système d’exploitation, prévues pour l’automne 2024. Pour plus d’informations, consultez Modifications du comportement de l’API pour l’accès Wi-Fi et l’emplacement.

Définit sur un objet WiFiOnDemandHotspotNetwork différentes propriétés du réseau hotspot, telles que le pourcentage de batterie, le nom d’affichage, la disponibilité et le SSID/mot de passe. Si une propriété n’est pas valide, UpdateProperties lève une exception d’argument non valide.

Notes

Si vous souhaitez utiliser cette API dans une application UWP et publier votre application sur le Microsoft Store, vous devez demander une approbation spéciale pour utiliser la fonctionnalité personnalisée Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (fonctionnalité réseau à la demande). Pour plus d’informations, consultez Fonctionnalités personnalisées.

La fonctionnalité de réseau à la demande sera mise à la disposition uniquement des développeurs d’applications qui créent des scénarios de Wi-Fi de bout en bout entre un appareil matériel compatible avec connexion et un PC Windows.

S’applique à

Voir aussi

  • <xref:%0a%0a-+%5bWiFiOnDemandHotspotUpdateMetadataTrigger%5d(%2fuwp%2fapi%2fwindows.applicationmodel.background.wifiondemandhotspotupdatemetadatatrigger)%0a-+%5bWiFiOnDemandHotspotConnectTrigger%5d(%2fuwp%2fapi%2fwindows.applicationmodel.background.wifiondemandhotspotconnecttrigger)>