共用方式為

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

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

Cf執行

  • Last updated on