TetheringEntitlementCheckTrigger Classe

Definição

Namespace:

Windows.ApplicationModel.Background

Representa um evento de amarração que dispara uma tarefa em segundo plano a ser executada.

public ref class TetheringEntitlementCheckTrigger sealed : IBackgroundTrigger

/// [Windows.Foundation.Metadata.Activatable(393216, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 393216)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class TetheringEntitlementCheckTrigger final : IBackgroundTrigger

[Windows.Foundation.Metadata.Activatable(393216, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 393216)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class TetheringEntitlementCheckTrigger : IBackgroundTrigger

function TetheringEntitlementCheckTrigger()

Public NotInheritable Class TetheringEntitlementCheckTrigger
Implements IBackgroundTrigger

Herança

Object Platform::Object IInspectable TetheringEntitlementCheckTrigger

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementações

IBackgroundTrigger

Requisitos do Windows

Família de dispositivos	Windows 10, version 1803 (introduzida na 10.0.17134.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v6.0)
Funcionalidades do aplicativo	networkConnectionManagerProvisioning

Exemplos

O exemplo a seguir mostra como criar e registrar um gatilho de tethering:

using Windows.ApplicationModel.Background;

void RegisterTetheringTrigger()
{
  bool taskAlreadyRegistered = false;
  string exampleTaskName = "MyEntitlementTask";

  foreach (var task in BackgroundTaskRegistration.AllTasks)
  {
      if (task.Value.Name == exampleTaskName)
      {
          taskAlreadyRegistered = true;
          break;
      }
  }

  if (!taskAlreadyRegistered)
  {
      var builder = new BackgroundTaskBuilder();

      builder.Name = exampleTaskName;
      builder.TaskEntryPoint = "Sample.TheActualBackgroundTask";
      var trigger = new TetheringEntitlementCheckTrigger();
      builder.SetTrigger(trigger);
      builder.Register();
  }
}

Comentários

Quando esse gatilho é registrado e o cliente da rede celular tenta ativar o tethering por meio da interface do usuário do Windows, a tarefa em segundo plano é disparada. Como uma operadora de rede móvel, você pode usar a tarefa em segundo plano disparada para se comunicar com o Windows se o cliente da rede celular tem permissão para usar o recurso de ligação com base em seus direitos.

A tarefa em segundo plano só será disparada se estiver registrada corretamente no banco de dados DO COSA (Ativo de Configurações do País e do Operador) para operadoras móveis. Confira Configurações do banco de dados COSA/APN da área de trabalho para obter detalhes.

Aviso

O gatilho de tethering pode não se comportar conforme o esperado se for registrado novamente várias vezes

Construtores

TetheringEntitlementCheckTrigger()

Cria e inicializa uma nova instância de um gatilho de evento de tethering.