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 がファイルまたはディレクトリのさまざまな情報を解析できない場合、これは無効な状態です。 |

要件

要件	値
サポートされている最小のクライアント	Windows 10バージョン 1709 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2016 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	cfapi.h
Library	CldApi.lib
[DLL]	CldApi.dll

こちらもご覧ください

CF_PLACEHOLDER_STATE