CF_PLACEHOLDER_CREATE_INFO 構造体 (cfapi.h)
新しいプレースホルダー ファイルまたはディレクトリを作成するためのプレースホルダー情報が含まれます。
構文
typedef struct CF_PLACEHOLDER_CREATE_INFO {
LPCWSTR RelativeFileName;
CF_FS_METADATA FsMetadata;
LPCVOID FileIdentity;
DWORD FileIdentityLength;
CF_PLACEHOLDER_CREATE_FLAGS Flags;
HRESULT Result;
USN CreateUsn;
} CF_PLACEHOLDER_CREATE_INFO;
メンバー
RelativeFileName
作成する子プレースホルダー ファイルまたはディレクトリの名前。 ファイル名またはディレクトリ名のみで構成する必要があります。
たとえば、プロバイダーの同期ルートが C:\SyncRoot の場合、同期ルートのサブディレクトリに placeholder.txt という名前のプレースホルダーを作成するには、BaseDirectoryPath が と等しい CfCreatePlaceholders 関数をC:\SyncRoot\SubDirectory呼び出し、CF_PLACEHOLDER_CREATE_INFOの RelativePathName フィールドを にplaceholder.txt設定します。
FsMetadata
プレースホルダーを使用して作成されるファイル システム メタデータ 。すべてのタイムスタンプ、ファイル属性、ファイル サイズ (ディレクトリの場合は省略可能)。
FileIdentity
同期プロバイダーによって提供されるファイル情報を含むユーザー モード バッファー。 FileIdentity BLOB のサイズは、CF_PLACEHOLDER_MAX_FILE_IDENTITY_LENGTH (4 KB に定義) を超えないようにしてください。 FileIdentity は、すべてのコールバックで同期プロバイダーに返されます。 これはファイルに必要です (ディレクトリの場合は必要ありません)。
FileIdentityLength
FileIdentity の長さ (バイト単位)。
Flags
プレースホルダーの作成動作を指定するためのフラグ。 詳細については、「 CF_PLACEHOLDER_CREATE_FLAGS 」を参照してください。
Result
プレースホルダーの作成結果。 正常に作成されると、値は STATUS_OK。
CreateUsn
作成アクション後の最終的な USN 値が実行されます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 10、バージョン 1709 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2016 [デスクトップ アプリのみ] |
| Header | cfapi.h |