CF_PIN_STATE列舉 (cfapi.h)
釘選佔位元檔案或目錄的狀態。
Syntax
typedef enum CF_PIN_STATE {
CF_PIN_STATE_UNSPECIFIED = 0,
CF_PIN_STATE_PINNED = 1,
CF_PIN_STATE_UNPINNED = 2,
CF_PIN_STATE_EXCLUDED = 3,
CF_PIN_STATE_INHERIT = 4
} ;
常數
CF_PIN_STATE_UNSPECIFIED值： 0 當佔位元元的內容需要在磁碟本機存在或不存在時，平臺可以自由決定。 |
CF_PIN_STATE_PINNED值： 1 同步處理提供者會在平臺收到釘選要求之後，以異步方式擷取佔位符的內容。 不保證 在 CfSetPinState 呼叫成功完成之後，要釘選的佔位元元將會在本機完全可用。 不過，平臺會在釘選的佔位符上失敗任何解除凍結要求。 |
CF_PIN_STATE_UNPINNED值： 2 同步處理提供者會在平臺收到取消釘選要求之後，以異步方式將佔位符的內容解除凍結/失效。 不保證在 API 呼叫順利完成之後，將會完全解除凍結要取消釘選的佔位符。 |
CF_PIN_STATE_EXCLUDED值： 3 佔位符永遠不會由同步提供者同步處理至雲端。 這個狀態只能由同步提供者設定。 |
CF_PIN_STATE_INHERIT值： 4 平臺會將它視為呼叫端在佔位元上執行移動作業，因此會根據其父系的釘選狀態重新評估佔位元的釘選狀態。 如需繼承數據表 ，請參閱 一節。 |
備註
| Parent | [未指定] | Pinned | 未釘選 | 已排除 | |
|---|---|---|---|---|---|
| 檔案 | [未指定] | [未指定] | Pinned | [未指定] | 已排除 |
| Pinned | Pinned | Pinned | Pinned | 已排除 | |
| 未釘選 | 未釘選 | 未釘選 | 未釘選 | 已排除 | |
| 已排除 | [未指定] | Pinned | [未指定] | 已排除 | |
| 目錄 | [未指定] | [未指定] | Pinned | 未釘選 | 已排除 |
| Pinned | Pinned | Pinned | Pinned | 已排除 | |
| 未釘選 | 未釘選 | 未釘選 | 未釘選 | 已排除 | |
| 已排除 | [未指定] | Pinned | 未釘選 | 已排除 |
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 10 1709 版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2016 [僅限傳統型應用程式] |
| 標頭 | cfapi.h |