SubscribeActivityCoordinatorPolicy-Funktion (activitycoordinator.h)

Erstellt ein Abonnement, das Koordinationsbenachrichtigungen an den bereitgestellten Rückruf basierend auf der Konfiguration der Richtlinie bereitstellt. Bei 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
);

Die Parameter

policy

Stellt ein Handle für die Zielrichtlinie bereit.

callback

Stellt den Rückruf bereit, der für alle Koordinationsbenachrichtigungen dieses Abonnements 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.

Bemerkungen

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

Anmerkung Blockieren Sie diesen Rückruf nicht für längere Zeiträume, da es unsubscribeActivityCoordinatorPolicy blockiert und möglicherweise zur Erschöpfung des Threadpools beitragen kann.

Anmerkung Aufrufe von UnsubscribeActivityCoordinatorPolicy aus diesem Rückruf schlagen fehl. Die Nichtzuschreibung muss außerhalb des Rückrufs erfolgen.

Anforderungen

Siehe auch

UnsubscribeActivityCoordinatorPolicy

ACTIVITY_COORDINATOR_CALLBACK

ACTIVITY_COORDINATOR_NOTIFICATION