Condividi tramite


NetworkOperatorTetheringManager.CreateFromConnectionProfile Metodo

Definizione

Overload

CreateFromConnectionProfile(ConnectionProfile)

Crea un oggetto NetworkOperatorTetheringManager usando il profilo specificato come interfaccia pubblica e Wi-Fi come interfaccia privata.

CreateFromConnectionProfile(ConnectionProfile, NetworkAdapter)

Crea un networkOperatorTetheringManager usando il profilo specificato come interfaccia pubblica e nell'interfaccia privata specificata.

CreateFromConnectionProfile(ConnectionProfile)

Crea un oggetto NetworkOperatorTetheringManager usando il profilo specificato come interfaccia pubblica e Wi-Fi come interfaccia privata.

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 NetworkOperatorTetheringManager

Parametri

profile
ConnectionProfile

Profilo di connessione da usare.

Restituisce

Oggetto manager risultante.

Attributi

Requisiti Windows

Funzionalità dell'app
wiFiControl

Commenti

Nelle versioni precedenti solo le app con privilegi degli operatori di rete possono creare un oggetto NetworkOperatorTetheringManager e usarlo per controllare il tethering. In questa versione qualsiasi app può creare l'oggetto chiamando CreateFromConnectionProfile. Affinché la chiamata abbia esito positivo, tuttavia, l'app deve avere la funzionalità del dispositivo di controllo Wi-Fi appropriata dichiarata nel manifesto. Nell'esempio seguente viene illustrata parte di un manifesto con il tag DeviceCapability necessario, con l'attributo wiFiControl .

<Capabilities>
  <DeviceCapability Name="wiFiControl"/>
</Capabilities>

Se la funzionalità del dispositivo wiFiControl non è impostata nel manifesto, le chiamate a CreateFromConnectionProfile non riescono generando un'eccezione.

Il codice può determinare se la funzionalità è impostata in fase di esecuzione chiamando GetTetheringCapabilityFromConnectionProfile. Se disabledBySystemCapability viene restituito, il manifesto non imposta la funzionalità del dispositivo richiesta. Si noti che anche se abilitato viene restituito, il codice deve essere scritto per gestire gli errori e le eccezioni, poiché la funzionalità di tethering può cambiare in qualsiasi momento, al di fuori del controllo o dell'avviso dell'app.

Vedi anche

Si applica a

CreateFromConnectionProfile(ConnectionProfile, NetworkAdapter)

Crea un networkOperatorTetheringManager usando il profilo specificato come interfaccia pubblica e nell'interfaccia privata specificata.

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 NetworkOperatorTetheringManager

Parametri

profile
ConnectionProfile

Profilo di connessione da usare.

adapter
NetworkAdapter

Scheda di rete in cui la connessione è condivisa. La connessione condivisa verrà controllata da NetworkOperatorTetheringManager.

Restituisce

Oggetto manager risultante.

Attributi

Requisiti Windows

Famiglia di dispositivi
Windows 10 Anniversary Edition (è stato introdotto in 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v3.0)
Funzionalità dell'app
wiFiControl

Commenti

Nelle versioni precedenti solo le app con privilegi degli operatori di rete possono creare un oggetto NetworkOperatorTetheringManager e usarlo per controllare il tethering. In questa versione qualsiasi app può creare l'oggetto chiamando CreateFromConnectionProfile. Affinché la chiamata abbia esito positivo, tuttavia, l'app deve avere la funzionalità del dispositivo di controllo Wi-Fi appropriata dichiarata nel manifesto. Nell'esempio seguente viene illustrata parte di un manifesto con il tag DeviceCapability necessario, con l'attributo wiFiControl .

<Capabilities>
  <DeviceCapability Name="wiFiControl"/>
</Capabilities>

Se la funzionalità del dispositivo wiFiControl non è impostata nel manifesto, le chiamate a CreateFromConnectionProfile non riescono generando un'eccezione.

Il codice può determinare se la funzionalità è impostata in fase di esecuzione chiamando GetTetheringCapabilityFromConnectionProfile. Se disabledBySystemCapability viene restituito, il manifesto non imposta la funzionalità del dispositivo richiesta. Si noti che anche se abilitato viene restituito, il codice deve essere scritto per gestire gli errori e le eccezioni, poiché la funzionalità di tethering può cambiare in qualsiasi momento, al di fuori del controllo o dell'avviso dell'app.

Vedi anche

Si applica a