SubscribeActivityCoordinatorPolicy 関数 (activitycoordinator.h)

  • [アーティクル]

ポリシーの構成に基づいて、指定されたコールバックに調整通知を配信するサブスクリプションを作成します。 通知時に、指定されたコールバックが指定されたコンテキストで実行されます。 現在の状態の通知は、別のスレッドですぐに配信され、この呼び出しが返される前に配信される場合があります。 サブスクライブ後にポリシーに加えられた変更は、サブスクリプションには影響しません。 1 つのポリシーを使用して、一意のポリシー構成を使用して多数のサブスクリプションを作成できます。 通知はシリアル化されます。

構文

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

パラメーター

policy

ターゲット ポリシーへのハンドルを提供します。

callback

このサブスクリプションからのすべての調整通知に対して実行されるコールバックを提供します。

callbackContext

コールバック ルーチンに渡されるコンテキストを提供します。

subscription

作成されたサブスクリプション ハンドルを受け取る ACTIVITY_COORDINATOR_SUBSCRIPTION ハンドルへのポインターを提供します。

戻り値

HRESULT を返します。

注釈

メモ このコールバックでは、このサブスクリプションの今後のポリシー通知の配信がブロックされるため、このコールバックではアクティビティを実行しないでください。 このコールバックは、API からの RUN/STOP 通知に応答して、アクティビティの開始と停止を調整するために使用する必要があります。

メモUnsubscribeActivityCoordinatorPolicy がブロックされ、スレッド プールの枯渇に寄与する可能性があるため、このコールバックを長期間ブロックしないでください。

メモ このコールバックからの UnsubscribeActivityCoordinatorPolicy の呼び出しは失敗します。 サブスクライブ解除は、コールバックの外部で行う必要があります。

要件

要件 値
Header activitycoordinator.h

こちらもご覧ください

UnsubscribeActivityCoordinatorPolicy

ACTIVITY_COORDINATOR_CALLBACK

ACTIVITY_COORDINATOR_NOTIFICATION