Partager via


WiFiOnDemandHotspotNetwork.GetOrCreateById(Guid) Méthode

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 Wi-Fi l’accès 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é 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 et un PC Windows.

public:
 static WiFiOnDemandHotspotNetwork ^ GetOrCreateById(Platform::Guid networkId);
 static WiFiOnDemandHotspotNetwork GetOrCreateById(winrt::guid const& networkId);
public static WiFiOnDemandHotspotNetwork GetOrCreateById(Guid networkId);
function getOrCreateById(networkId)
Public Shared Function GetOrCreateById (networkId As Guid) As WiFiOnDemandHotspotNetwork

Paramètres

networkId
Guid

Platform::Guid

winrt::guid

Identificateur global unique (GUID) qui identifie un objet WiFiOnDemandHotspotNetwork .

Retours

Objet créé ou récupéré.

Configuration requise pour Windows

Fonctionnalités de l’application
onDemandHotspotControl

Remarques

  • L’ID peut être n’importe quelle valeur que l’application choisit d’utiliser pour distinguer plusieurs points d’accès à la demande. Toutefois, pour des performances optimales avec des connexions éphémères, nous vous recommandons de réutiliser le même ID et de mettre à jour le SSID et le mot de passe au lieu de créer de nouveaux réseaux pour chacun d’eux.
  • L’ID doit uniquement être unique au sein d’une application.
  • L’application appelante doit avoir l’identité de package.

S’applique à