IUIAnimationManager：：SetCancelPriorityComparison 方法 (uianimation.h)

設定要呼叫的優先順序比較處理程式，以判斷是否可以取消排程的分鏡腳本。

語法

HRESULT SetCancelPriorityComparison(
  [in, optional] IUIAnimationPriorityComparison *comparison
);

[in, optional] comparison

取消的優先順序比較處理程式。

指定的對象必須實作 IUIAnimationPriorityComparison 介面或 為 NULL。

請參閱＜備註＞。

如果方法成功，它會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。如需錯誤碼的清單，請參閱 Windows 動畫錯誤碼。

使用此方法設定優先順序比較處理程式，可讓應用程式指出排程衝突的解決時機，方法是取消分鏡腳本。

只有在尚未開始播放，且使用此方法註冊的優先順序比較對象會傳回 S_OK時，才能取消已排程的分鏡腳本。已取消的分鏡腳本會從排程完全移除。

傳遞 NULL 做為比較參數，會導致 Windows 動畫對其先前傳入的任何優先順序比較處理程式物件釋出其參考。這項技術對於中斷參考迴圈而言可能很重要，而不需要呼叫 IUIAnimationManager：：Shutdown 方法。

需求	值
最低支援的用戶端	適用於 Windows Vista 的 Windows 7、Windows Vista 和平臺更新 [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	都不支援
目標平台	Windows
標頭	uianimation.h
Dll	UIAnimation.dll