Funzione SubscribeActivityCoordinatorPolicy (activitycoordinator.h)
Crea una sottoscrizione che recapita notifiche di coordinamento al callback fornito in base alla configurazione del criterio. Al momento della notifica, il callback fornito viene eseguito con il contesto fornito. Una notifica con lo stato corrente verrà recapitata immediatamente in un thread separato e può essere recapitata prima che la chiamata venga restituita. Le modifiche apportate al criterio dopo la sottoscrizione non influiscono sulla sottoscrizione. È possibile usare un singolo criterio per creare molte sottoscrizioni con configurazioni di criteri univoche. Le notifiche vengono serializzate.
Sintassi
HRESULT SubscribeActivityCoordinatorPolicy(
ACTIVITY_COORDINATOR_POLICY policy,
ACTIVITY_COORDINATOR_CALLBACK callback,
void *callbackContext,
ACTIVITY_COORDINATOR_SUBSCRIPTION *subscription
);
Parametri
policy
Fornisce un handle ai criteri di destinazione.
callback
Fornisce il callback da eseguire per tutte le notifiche di coordinamento da questa sottoscrizione.
callbackContext
Fornisce il contesto da passare alla routine di callback.
subscription
Fornisce un puntatore a un handle di ACTIVITY_COORDINATOR_SUBSCRIPTION che riceve l'handle di sottoscrizione creato.
Valore restituito
Restituisce un valore HRESULT.
Commenti
Nota Non eseguire l'attività in questo callback, perché bloccherà il recapito delle notifiche future dei criteri per questa sottoscrizione. Questo callback deve essere usato per coordinare l'avvio e l'arresto dell'attività in risposta alle notifiche RUN/STOP dall'API.
Nota Non bloccare questo callback per lunghi periodi di tempo, perché blocca UnsubscribeActivityCoordinatorPolicy e può contribuire all'esaurimento del pool di thread.
Nota Le chiamate a UnsubscribeActivityCoordinatorPolicy da questo callback avranno esito negativo. L'annullamento della sottoscrizione deve verificarsi all'esterno del callback.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | activitycoordinator.h |