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 等于 C:\SyncRoot\SubDirectory 的情况下调用 CfCreatePlaceholders 函数，并将CF_PLACEHOLDER_CREATE_INFO的 RelativePathName 字段设置为 placeholder.txt。
FsMetadata
使用占位符创建的文件系统元数据，包括所有时间戳、文件属性和文件大小， (目录) 可选。
FileIdentity
包含同步提供程序提供的文件信息的用户模式缓冲区。 FileIdentity blob 的大小不应超过CF_PLACEHOLDER_MAX_FILE_IDENTITY_LENGTH (定义为 4KB) 。 FileIdentity 在所有回调中传递回同步提供程序。 这是文件 (目录) 所必需的。
FileIdentityLength
FileIdentity 的长度（以字节为单位）。
Flags
用于指定占位符创建行为的标志。 有关详细信息 ，请参阅CF_PLACEHOLDER_CREATE_FLAGS 。
Result
占位符创建的结果。 成功创建后，该值 STATUS_OK。
CreateUsn
执行创建操作后的最终 USN 值。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 10版本 1709 [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2016 [仅限桌面应用] |
| 标头 | cfapi.h |