CfGetPlaceholderStateFromAttributeTag 函式 (cfapi.h)

根據 檔案的 FileAttributes 和 ReparseTag 值，取得一組佔位符狀態。

語法

CF_PLACEHOLDER_STATE CfGetPlaceholderStateFromAttributeTag(
  [in] DWORD FileAttributes,
  [in] DWORD ReparseTag
);

參數

[in] FileAttributes

檔案屬性資訊。

[in] ReparseTag

重新分析檔案中的標記資訊。

傳回值

可以包含 CF_PLACEHOLDER_STATE;佔位元狀態。

備註

FileAttributes 和 ReparseTag 可以藉由列出包含檔案的目錄，或在檔案上直接查詢 FileAttributeTagInfo 來取得。

可以傳回下列 CF_PLACEHOLDER_STATE 值：

|佔位元狀態 |描述 | | CF_PLACEHOLDER_STATE_NO_STATES |傳回時，API 所檢查其屬性和重新分析標籤的檔案或目錄不是雲端檔案佔位元元。 | | CF_PLACEHOLDER_STATE_PLACEHOLDER |設定時，API 所檢查其屬性和重新分析標籤的檔案或目錄是雲端檔案佔位元元。 | | CF_PLACEHOLDER_STATE_SYNC_ROOT |設定時，目錄不只是雲端檔案佔位元目錄，也是同步根目錄。 | | CF_PLACEHOLDER_STATE_ESSENTIAL_PROP_PRESENT |設定時，檔案或目錄必須是雲端檔案佔位元，而且檔案或目錄的屬性存放區中有基本屬性。 | | CF_PLACEHOLDER_STATE_IN_SYNC |設定時，檔案或目錄必須是雲端檔案佔位元，且其內容與雲端同步。 | | CF_PLACEHOLDER_STATE_PARTIAL |當設定時，檔案或目錄必須是雲端檔案佔位元，而且其內容尚未可供使用者應用程式取用 (，不過它可能或可能未完全存在於本機) 。 例如，佔位符檔案的內容已完全下載到本機磁碟，但尚未由同步提供者驗證，該提供者已向凍結修飾詞註冊同步根目錄 VERIFICATION_REQUIRED。 | | CF_PLACEHOLDER_STATE_PARTIALLY_ON_DISK |設定時，檔案或目錄必須是雲端檔案佔位元，而且其內容未完全存在於本機。 設定 PARTIALLY_ON_DISK 時，也必須設定 PARTIAL 。 | | CF_PLACEHOLDER_STATE_INVALID |當 API 無法剖析檔案或目錄的各種資訊時，這是無效的狀態。 |

規格需求

另請參閱

CF_PLACEHOLDER_STATE