SubscribeActivityCoordinatorPolicy-Funktion (activitycoordinator.h)

Artikel
02/28/2024

Erstellt ein Abonnement, das koordinationsbenachrichtigungen an den angegebenen Rückruf basierend auf der Konfiguration der Richtlinie übermittelt. Nach der Benachrichtigung wird der angegebene Rückruf mit dem angegebenen Kontext ausgeführt. Eine Benachrichtigung mit dem aktuellen Status wird sofort in einem separaten Thread übermittelt und kann übermittelt werden, bevor dieser Aufruf zurückgegeben wird. Änderungen, die nach dem Abonnieren an der Richtlinie vorgenommen wurden, wirken sich nicht auf das Abonnement aus. Eine einzelne Richtlinie kann verwendet werden, um viele Abonnements mit eindeutigen Richtlinienkonfigurationen zu erstellen. Benachrichtigungen werden serialisiert.

Syntax

HRESULT SubscribeActivityCoordinatorPolicy(
  ACTIVITY_COORDINATOR_POLICY       policy,
  ACTIVITY_COORDINATOR_CALLBACK     callback,
  void                              *callbackContext,
  ACTIVITY_COORDINATOR_SUBSCRIPTION *subscription
);

Parameter

policy

Stellt der Zielrichtlinie ein Handle bereit.

callback

Stellt den Rückruf bereit, der für alle Koordinationsbenachrichtigungen aus diesem Abonnement ausgeführt werden soll.

callbackContext

Stellt den Kontext bereit, der an die Rückrufroutine übergeben werden soll.

subscription

Stellt einen Zeiger auf ein ACTIVITY_COORDINATOR_SUBSCRIPTION Handle bereit , das das erstellte Abonnementhandle empfängt.

Rückgabewert

Gibt ein HRESULT zurück.

Hinweise

Hinweis Führen Sie Ihre Aktivität in diesem Rückruf nicht aus, da dadurch die Übermittlung zukünftiger Richtlinienbenachrichtigungen für dieses Abonnement blockiert wird. Dieser Rückruf sollte verwendet werden, um das Starten und Beenden Ihrer Aktivität als Reaktion auf RUN/STOP-Benachrichtigungen der API zu koordinieren.

Hinweis Blockieren Sie diesen Rückruf nicht für einen längeren Zeitraum, da er UnsubscribeActivityCoordinatorPolicy blockiert und zur Erschöpfung des Threadpools beitragen kann.