通过

CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAGS枚举 （cfapi.h）

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

Syntax

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
} ;

Constants

 
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 回调。

重要

如果没有此标志，传输占位符回调将重复调用（可能为 100+ 次），因为系统继续按需请求占位符。 提供程序应设置此标志以指示已创建所有占位符，无需进一步回调。

提供程序在目录中创建完所有占位符后，应通过设置 CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION 标志将目录标记为完全填充。 这可以防止该目录再次调用 CF_CALLBACK_TYPE_FETCH_PLACEHOLDERS 回调。 通常，提供程序应在设置目录中的所有占位符后设置此标志，或者如果当前调用 CF_OPERATION_TYPE_TRANSFER_PLACEHOLDERS 应创建所有剩余的占位符。

提供程序可以随时设置此标志，如果当前调用 CF_OPERATION_TYPE_TRANSFER_PLACEHOLDERS，平台将遵循此标志：

1. TransferPlaceholders.PlaceholderTotalCount<= （上一 TransferPlaceholders.EntriesProcessed个的总和） + 当前 TransferPlaceholders.PlaceholderCount。
1.已成功创建所有当前 TransferPlaceholders.PlaceholderCount 占位符。

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

它可以执行以下作：

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

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

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

要求

Requirement 价值
最低支持的客户端 Windows 10 版本 1709 [仅限桌面应用]
支持的最低服务器 Windows Server 2016 [仅限桌面应用]
Header cfapi.h

另请参阅

CF_CALLBACK_TYPE

CF_OPERATION_TYPE

CfExecute