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

另请参阅

CF_PLACEHOLDER_CREATE_FLAGS

CfCreatePlaceholders