WiFiOnDemandHotspotNetwork.GetOrCreateById(Guid) Metodo

Definizione

Nota

Alcune informazioni sono relative a un prodotto non definitivo, che potrebbe subire modifiche sostanziali prima del rilascio sul mercato. Microsoft non offre alcuna garanzia, esplicita o implicita, relativamente alle informazioni fornite.

Importante

Questa API sarà influenzata dalle modifiche imminenti al comportamento del sistema operativo, pianificato per l'autunno 2024. Per altre informazioni, vedere Modifiche al comportamento dell'API per Wi-Fi accesso e posizione.

Se il sistema operativo (SISTEMA operativo) è già configurato con un hotspot dall'app chiamante, GetOrCreateById recupera l'oggetto WiFiOnDemandHotspotNetwork che corrisponde al networkId specificato. In caso contrario, il metodo crea una nuova rete per tale ID.

Nota

Se si vuole usare questa API in un'app UWP e pubblicare l'app in Microsoft Store, sarà necessario richiedere l'approvazione speciale per usare la funzionalità personalizzata Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (funzionalità di rete on demand). Per altre informazioni, vedere Funzionalità personalizzate.

La funzionalità Di rete on demand verrà resa disponibile solo per gli sviluppatori di app che creano scenari di hotspot end-to-Wi-Fi end tra un dispositivo hardware compatibile con tethering e 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

Parametri

networkId
Guid

Platform::Guid

winrt::guid

Identificatore univoco globale (GUID) che identifica un oggetto WiFiOnDemandHotspotNetwork .

Restituisce

Oggetto creato o recuperato.

Requisiti Windows

Funzionalità dell'app
onDemandHotspotControl

Commenti

  • L'ID può essere qualsiasi valore scelto dall'app per distinguere più hotspot su richiesta. Tuttavia, per ottenere prestazioni ottimali con connessioni temporanee, è consigliabile riutilizzare lo stesso ID e aggiornare SSID e Password anziché creare nuove reti per ognuna.
  • L'ID deve essere univoco solo all'interno di un'app.
  • L'app chiamante deve avere l'identità del pacchetto.

Si applica a