WiFiOnDemandHotspotNetwork.GetOrCreateById(Guid) Método

Definição

Namespace:

Windows.Devices.WiFi

Observação

Algumas informações relacionam-se ao produto de pré-lançamento, o qual poderá ser substancialmente modificado antes do lançamento comercial. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Importante

Essa API será afetada pelas próximas alterações no comportamento do sistema operacional, previstas para o outono de 2024. Para obter mais informações, consulte Alterações no comportamento da API para Wi-Fi acesso e localização.

Se o sistema operacional (SO) já estiver configurado com um hotspot do aplicativo de chamada, GetOrCreateById recuperará o objeto WiFiOnDemandHotspotNetwork que corresponde ao networkId fornecido. Caso contrário, o método criará uma nova rede para essa ID.

Observação

Se você quiser usar essa API em um aplicativo UWP e publicar seu aplicativo na Microsoft Store, precisará solicitar aprovação especial para usar a funcionalidade personalizada Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (a funcionalidade rede sob demanda). Para obter mais informações, consulte Recursos personalizados.

A funcionalidade rede sob demanda será disponibilizada somente para desenvolvedores de aplicativos que criam cenários de hotspot de ponta a ponta Wi-Fi entre um dispositivo de hardware compatível com tethering e um computador 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

Parâmetros

networkId

Guid

Platform::Guid

winrt::guid

O GUID (identificador global exclusivo) que identifica um objeto WiFiOnDemandHotspotNetwork .

Retornos

WiFiOnDemandHotspotNetwork

O objeto que foi criado ou recuperado.

Requisitos do Windows

Funcionalidades do aplicativo

onDemandHotspotControl

Comentários

• A ID pode ser qualquer valor que o aplicativo optar por usar para distinguir vários hotspots sob demanda. No entanto, para obter o melhor desempenho com conexões efêmeras, recomendamos reutilização da mesma ID e atualização do SSID e senha em vez de criar novas redes para cada uma delas.
• A ID só precisa ser exclusiva dentro de um aplicativo.
• O aplicativo de chamada deve ter a identidade do pacote.