CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAGS枚举 (cfapi.h)

  • 项目

用于指定传输占位符文件或目录时的行为的标志。

语法

typedef enum CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAGS {
  CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_NONE = 0x00000000,
  CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_STOP_ON_ERROR = 0x00000001,
  CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION = 0x00000002
} ;

常量

 
CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_NONE
值： 0x00000000
没有传输占位符标志。
CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_STOP_ON_ERROR
值： 0x00000001
如果占位符传输失败，导致 API 立即返回。 如果传输失败，将返回错误代码。
CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION
值： 0x00000002
如果提供程序不再希望调用其CF_CALLBACK_TYPE_FETCH_PLACEHOLDERS回调，则应通过在 CF_OPERATION_TYPE_TRANSFER_PLACEHOLDERS 中设置CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION标志来标记占位符目录已完全填充。 通常，提供程序应在已设置目录中的所有占位符后设置此标志，或者如果 当前调用CF_OPERATION_TYPE_TRANSFER_PLACEHOLDERS 应该设置所有占位符。 提供程序可以随时设置此标志，如果 当前调用 期间CF_OPERATION_TYPE_TRANSFER_PLACEHOLDERS，平台将遵循此标志：

1. TransferPlaceholders.PlaceholderTotalCount<= (之前 TransferPlaceholders.EntriesProcessed) + 当前 TransferPlaceholders.PlaceholderCount的总和。
2. 已成功创建所有当前 TransferPlaceholders.PlaceholderCount 占位符。

例如，如果提供程序必须传输 10 个占位符，则它可以通过以下方式之一传输和设置 CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION 。

它可以执行此操作：

1. 将 TransferPlaceholders.PlaceholderTotalCount = 5、设置 TransferPlaceholders.PlaceholderCount4 = 和 设置为 。FlagsNONE
2. 将 TransferPlaceholders.PlaceholderTotalCount = 9、设置 TransferPlaceholders.PlaceholderCount4 = 和 设置为 。FlagsNONE
3. 将 TransferPlaceholders.PlaceholderTotalCount = 11、设置 TransferPlaceholders.PlaceholderCount2 = 和 设置为 。FlagsNONE
4. 将 TransferPlaceholders.PlaceholderTotalCount = 10、设置 TransferPlaceholders.PlaceholderCount0 = 和 设置为 。FlagsCF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION

或者，它可以执行以下操作：

1. 将 TransferPlaceholders.PlaceholderTotalCount = 5、设置 TransferPlaceholders.PlaceholderCount4 = 和 设置为 。FlagsNONE
2. 将 TransferPlaceholders.PlaceholderTotalCount = 9、设置 TransferPlaceholders.PlaceholderCount4 = 和 设置为 。FlagsNONE
3. 将 TransferPlaceholders.PlaceholderTotalCount = 10、设置 TransferPlaceholders.PlaceholderCount2 = 和 设置为 。FlagsCF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION

要求

要求 值
最低受支持的客户端 Windows 10版本 1709 [仅限桌面应用]
最低受支持的服务器 Windows Server 2016 [仅限桌面应用]
标头 cfapi.h

另请参阅

CF_CALLBACK_TYPE

CF_OPERATION_TYPE

CfExecute