Compartir a través de


NetworkOperatorTetheringManager.CreateFromConnectionProfile Método

Definición

Sobrecargas

CreateFromConnectionProfile(ConnectionProfile)

Crea un NetworkOperatorTetheringManager con el perfil especificado como interfaz pública y Wi-Fi como interfaz privada.

CreateFromConnectionProfile(ConnectionProfile, NetworkAdapter)

Crea un NetworkOperatorTetheringManager con el perfil especificado como interfaz pública y en networkAdapter dado como interfaz privada.

CreateFromConnectionProfile(ConnectionProfile)

Crea un NetworkOperatorTetheringManager con el perfil especificado como interfaz pública y Wi-Fi como interfaz 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 NetworkOperatorTetheringManager

Parámetros

profile
ConnectionProfile

Perfil de conexión que se va a usar.

Devoluciones

Objeto de administrador resultante.

Atributos

Requisitos de Windows

Características de aplicaciones
wiFiControl

Comentarios

En versiones anteriores, solo las aplicaciones con privilegios de los operadores de red podían crear un objeto NetworkOperatorTetheringManager y usarlo para controlar el tethering. En esta versión, cualquier aplicación puede crear el objeto llamando a CreateFromConnectionProfile. Sin embargo, para que la llamada se realice correctamente, la aplicación debe tener la funcionalidad del dispositivo de control Wi-Fi adecuada declarada en su manifiesto. En el ejemplo siguiente se muestra parte de un manifiesto con la etiqueta DeviceCapability necesaria, con el atributo wiFiControl .

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

Si la funcionalidad del dispositivo wiFiControl no está establecida en el manifiesto, las llamadas a CreateFromConnectionProfile producirán un error al producir una excepción.

El código puede determinar si la funcionalidad se establece en tiempo de ejecución mediante una llamada a GetTetheringCapabilityFromConnectionProfile. Si se devuelve DisabledBySystemCapability , el manifiesto no establece la funcionalidad del dispositivo necesaria. Ten en cuenta que, incluso si se devuelve Enabled , el código debe escribirse para controlar errores y excepciones, ya que la funcionalidad de tethering puede cambiar en cualquier momento, fuera del control o aviso de la aplicación.

Consulte también

Se aplica a

CreateFromConnectionProfile(ConnectionProfile, NetworkAdapter)

Crea un NetworkOperatorTetheringManager con el perfil especificado como interfaz pública y en networkAdapter dado como interfaz 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 NetworkOperatorTetheringManager

Parámetros

profile
ConnectionProfile

Perfil de conexión que se va a usar.

adapter
NetworkAdapter

Adaptador de red donde se comparte la conexión. La conexión compartida se controlará mediante NetworkOperatorTetheringManager.

Devoluciones

Objeto de administrador resultante.

Atributos

Requisitos de Windows

Familia de dispositivos
Windows 10 Anniversary Edition (se introdujo en la versión 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v3.0)
Características de aplicaciones
wiFiControl

Comentarios

En versiones anteriores, solo las aplicaciones con privilegios de los operadores de red podían crear un objeto NetworkOperatorTetheringManager y usarlo para controlar el tethering. En esta versión, cualquier aplicación puede crear el objeto llamando a CreateFromConnectionProfile. Sin embargo, para que la llamada se realice correctamente, la aplicación debe tener la funcionalidad del dispositivo de control Wi-Fi adecuada declarada en su manifiesto. En el ejemplo siguiente se muestra parte de un manifiesto con la etiqueta DeviceCapability necesaria, con el atributo wiFiControl .

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

Si la funcionalidad del dispositivo wiFiControl no está establecida en el manifiesto, las llamadas a CreateFromConnectionProfile producirán un error al producir una excepción.

El código puede determinar si la funcionalidad se establece en tiempo de ejecución mediante una llamada a GetTetheringCapabilityFromConnectionProfile. Si se devuelve DisabledBySystemCapability , el manifiesto no establece la funcionalidad del dispositivo necesaria. Ten en cuenta que, incluso si se devuelve Enabled , el código debe escribirse para controlar errores y excepciones, ya que la funcionalidad de tethering puede cambiar en cualquier momento, fuera del control o aviso de la aplicación.

Consulte también

Se aplica a