BackgroundTaskBuilder.SetTaskEntryPointClsid(Guid) Metodo

Definizione

Spazio dei nomi:

Windows.ApplicationModel.Background

Assegna un punto di ingresso CLSID COM usando un oggetto BackgroundTaskBuilder esistente.

public:
 virtual void SetTaskEntryPointClsid(Platform::Guid TaskEntryPoint) = SetTaskEntryPointClsid;

void SetTaskEntryPointClsid(winrt::guid const& TaskEntryPoint);

public void SetTaskEntryPointClsid(Guid TaskEntryPoint);

function setTaskEntryPointClsid(TaskEntryPoint)

Public Sub SetTaskEntryPointClsid (TaskEntryPoint As Guid)

Parametri

TaskEntryPoint

Guid

Platform::Guid

winrt::guid

Nome della classe TaskEntryPoint definita dall'applicazione.

Requisiti Windows

Famiglia di dispositivi	Windows 10, version 2004 (è stato introdotto in 10.0.19041.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v10.0)

Esempio

L'esempio di codice seguente illustra l'uso di BackgroundTaskBuilder per registrare l'attività in background COM WinMain creata in un trigger temporale in un intervallo di 15 minuti.

Il codice di esempio evita di creare attività duplicate controllando se un'attività in background con un nome di attività specifico è già registrata. Questa operazione viene eseguita nel codice di esempio perché la finalità è che esiste una sola registrazione attività in background specifica.

Spetta allo sviluppatore di app creare una o più attività in background con lo stesso punto di ingresso (o trigger o nome).

 using System;
 using Windows.ApplicationModel.Background;

 public IBackgroundTaskRegistration RegisterBackgroundTaskWithSystem(IBackgroundTrigger trigger, Guid entryPointClsid, string taskName)
 {
     foreach (var registrationIterator in BackgroundTaskRegistration.AllTasks)
     {
         if (registrationIterator.Value.Name == taskName)
         {
             return registrationIterator.Value;
         }
     }

     BackgroundTaskBuilder builder = new BackgroundTaskBuilder();

     builder.SetTrigger(trigger);
     builder.SetTaskEntryPointClsid(entryPointClsid);
     builder.Name = taskName;

     BackgroundTaskRegistration registration;
     try
     {
         registration = builder.Register();
     }
     catch (Exception)
     {
         registration = null;
     }

     return registration;
 }

 RegisterBackgroundTaskWithSystem(new TimeTrigger(15, false), typeof(TimeTriggeredTask).GUID, typeof(TimeTriggeredTask).Name);

Commenti

Per le attivazioni CLSID COM classiche, il CLSID da attivare viene specificato tramite il metodo SetTaskEntryPointClsid durante la registrazione. La registrazione COM deve identificare un server COM out-of-process (ad esempio LocalServer32).

Vedi anche

• TaskEntryPoint