建立訂閱,根據原則的組態,將協調通知傳送至提供的回呼。 通知後,提供的回呼會使用提供的內容執行。 具有目前狀態的通知會立即傳遞在個別的執行緒上,而且可能會在此呼叫傳回之前傳遞。 訂閱後對政策所做的更改不會影響訂閱。 單一原則可用來建立許多具有唯一原則組態的訂用帳戶。 通知會序列化。
語法
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 將會失敗。 取消訂閱必須在回呼之外進行。
需求
| Requirement | 價值觀 |
|---|---|
| Header | 活動協調員.h |
| Library | OneCoreUAP.Lib |