SubscribeActivityCoordinatorPolicy 函式 (activitycoordinator.h)

建立訂用帳戶，以根據原則的組態，將協調通知傳遞至提供的回呼。 當收到通知時，提供的回呼會與提供的內容一起執行。 具有目前狀態的通知會立即在個別線程上傳遞，而且可能會在此呼叫傳回之前傳遞。 訂閱之後對原則所做的變更不會影響訂用帳戶。 單一原則可用來建立具有唯一原則設定的許多訂用帳戶。 通知會串行化。

語法

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 ，並可能導致線程集區耗盡。

注意 從這個回呼 取消訂閱ActivityCoordinatorPolicy 的呼叫將會失敗。 取消訂閱必須在回呼外部發生。

規格需求

另請參閱

UnsubscribeActivityCoordinatorPolicy

ACTIVITY_COORDINATOR_CALLBACK

ACTIVITY_COORDINATOR_NOTIFICATION