NetworkOperatorTetheringManager.CreateFromConnectionProfile Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| CreateFromConnectionProfile(ConnectionProfile) |
Cria um NetworkOperatorTetheringManager usando o perfil fornecido como a interface pública e Wi-Fi como a interface privada. |
| CreateFromConnectionProfile(ConnectionProfile, NetworkAdapter) |
Cria um NetworkOperatorTetheringManager usando o perfil fornecido como a interface pública e no NetworkAdapter fornecido como a interface privada. |
CreateFromConnectionProfile(ConnectionProfile)
Cria um NetworkOperatorTetheringManager usando o perfil fornecido como a interface pública e Wi-Fi como a interface privada.
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 NetworkOperatorTetheringManagerParâmetros
- profile
- ConnectionProfile
Perfil de conexão a ser usado.
Retornos
O objeto de gerente resultante.
- Atributos
Requisitos do Windows
| Funcionalidades do aplicativo |
wiFiControl
|
Comentários
Em versões anteriores, somente aplicativos privilegiados de operadores de rede poderiam criar um objeto NetworkOperatorTetheringManager e usá-lo para controlar o bloqueio. Nesta versão, qualquer aplicativo pode criar o objeto chamando CreateFromConnectionProfile. No entanto, para que a chamada tenha êxito, o aplicativo deve ter a funcionalidade de dispositivo de controle de Wi-Fi apropriada declarada em seu manifesto. O exemplo a seguir mostra parte de um manifesto com a marca DeviceCapability necessária, com o atributo wiFiControl .
<Capabilities>
<DeviceCapability Name="wiFiControl"/>
</Capabilities>
Se a funcionalidade do dispositivo wiFiControl não estiver definida no manifesto, as chamadas para CreateFromConnectionProfile falharão lançando uma exceção.
Seu código pode determinar se a funcionalidade está definida em runtime chamando GetTetheringCapabilityFromConnectionProfile. Se DisabledBySystemCapability for retornado, o manifesto não definirá a funcionalidade de dispositivo necessária. Observe que, mesmo que Habilitado seja retornado, seu código deve ser gravado para lidar com erros e exceções, já que a funcionalidade de tethering pode ser alterada a qualquer momento, fora do controle ou da notificação do aplicativo.
Confira também
Aplica-se a
CreateFromConnectionProfile(ConnectionProfile, NetworkAdapter)
Cria um NetworkOperatorTetheringManager usando o perfil fornecido como a interface pública e no NetworkAdapter fornecido como a interface privada.
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 NetworkOperatorTetheringManagerParâmetros
- profile
- ConnectionProfile
Perfil de conexão a ser usado.
- adapter
- NetworkAdapter
O adaptador de rede em que a conexão é compartilhada. A conexão compartilhada será controlada pelo NetworkOperatorTetheringManager.
Retornos
O objeto de gerente resultante.
- Atributos
Requisitos do Windows
| Família de dispositivos |
Windows 10 Anniversary Edition (introduzida na 10.0.14393.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduzida na v3.0)
|
| Funcionalidades do aplicativo |
wiFiControl
|
Comentários
Em versões anteriores, somente aplicativos privilegiados de operadores de rede poderiam criar um objeto NetworkOperatorTetheringManager e usá-lo para controlar o bloqueio. Nesta versão, qualquer aplicativo pode criar o objeto chamando CreateFromConnectionProfile. No entanto, para que a chamada tenha êxito, o aplicativo deve ter a funcionalidade de dispositivo de controle de Wi-Fi apropriada declarada em seu manifesto. O exemplo a seguir mostra parte de um manifesto com a marca DeviceCapability necessária, com o atributo wiFiControl .
<Capabilities>
<DeviceCapability Name="wiFiControl"/>
</Capabilities>
Se a funcionalidade do dispositivo wiFiControl não estiver definida no manifesto, as chamadas para CreateFromConnectionProfile falharão lançando uma exceção.
Seu código pode determinar se a funcionalidade está definida em runtime chamando GetTetheringCapabilityFromConnectionProfile. Se DisabledBySystemCapability for retornado, o manifesto não definirá a funcionalidade de dispositivo necessária. Observe que, mesmo que Habilitado seja retornado, seu código deve ser gravado para lidar com erros e exceções, já que a funcionalidade de tethering pode ser alterada a qualquer momento, fora do controle ou da notificação do aplicativo.