CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAGS enumeration (cfapi.h)

IMPORTANT

Without this flag, the transfer placeholders callback will be invoked repeatedly (potentially 100+ times) as the system continues to request placeholders on-demand. Providers should set this flag to indicate that all placeholders have been created and no further callbacks are needed.

When the provider has finished creating all placeholders in a directory, it should mark the directory as fully populated by setting the CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION flag. This prevents the CF_CALLBACK_TYPE_FETCH_PLACEHOLDERS callback from being invoked again for that directory. Typically, a provider should set this flag after it has laid down all the placeholders in the directory, or if the current invocation of CF_OPERATION_TYPE_TRANSFER_PLACEHOLDERS is supposed to create all remaining placeholders.

The provider can set this flag anytime and it will be honored by the platform if during the current invocation of CF_OPERATION_TYPE_TRANSFER_PLACEHOLDERS:

1. TransferPlaceholders.PlaceholderTotalCount <= (Sum of Prior TransferPlaceholders.EntriesProcessed) + Current TransferPlaceholders.PlaceholderCount.
1. All current TransferPlaceholders.PlaceholderCount placeholders are successfully created.

For example, if a provider has to transfer ten placeholders, it could transfer and set CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION in one of the following ways.

It could do this:

1. Set TransferPlaceholders.PlaceholderTotalCount = 5, set TransferPlaceholders.PlaceholderCount = 4, and set Flags to NONE.
1. Set TransferPlaceholders.PlaceholderTotalCount = 9, set TransferPlaceholders.PlaceholderCount = 4, and set Flags to NONE.
1. Set TransferPlaceholders.PlaceholderTotalCount = 11, set TransferPlaceholders.PlaceholderCount = 2, and set Flags to NONE.
1. Set TransferPlaceholders.PlaceholderTotalCount = 10, set TransferPlaceholders.PlaceholderCount = 0, and set Flags to CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION.

Or it could do the following:

1. Set TransferPlaceholders.PlaceholderTotalCount = 5, set TransferPlaceholders.PlaceholderCount = 4, and set Flags to NONE.
1. Set TransferPlaceholders.PlaceholderTotalCount = 9, set TransferPlaceholders.PlaceholderCount = 4, and set Flags to NONE.
1. Set TransferPlaceholders.PlaceholderTotalCount = 10, set TransferPlaceholders.PlaceholderCount = 2, and set Flags to CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION.