共用方式為

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

常數

 
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 佔位符。

例如，如果提供者必須傳送十個佔位元，它可以以下列其中一種方式傳送和設定 CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION 。

它可以這麼做：

1.將 TransferPlaceholders.PlaceholderTotalCount = 5、設定TransferPlaceholders.PlaceholderCount = 4 和 設定Flags為 。NONE
2.將 TransferPlaceholders.PlaceholderTotalCount = 9、設定TransferPlaceholders.PlaceholderCount = 4 和 設定Flags為 。NONE
3.將 TransferPlaceholders.PlaceholderTotalCount = 11、設定TransferPlaceholders.PlaceholderCount = 2 和 設定Flags為 。NONE
4.將 TransferPlaceholders.PlaceholderTotalCount = 10、設定TransferPlaceholders.PlaceholderCount = 0 和 設定Flags為 。CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION

或者，它可以執行下列動作：

1.將 TransferPlaceholders.PlaceholderTotalCount = 5、設定TransferPlaceholders.PlaceholderCount = 4 和 設定Flags為 。NONE
2.將 TransferPlaceholders.PlaceholderTotalCount = 9、設定TransferPlaceholders.PlaceholderCount = 4 和 設定Flags為 。NONE
3.將 TransferPlaceholders.PlaceholderTotalCount = 10、設定TransferPlaceholders.PlaceholderCount = 2 和 設定Flags為 。CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION

規格需求

需求 值
最低支援的用戶端 Windows 10 1709 版 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2016 [僅限傳統型應用程式]
標頭 cfapi.h

另請參閱

CF_CALLBACK_TYPE

CF_OPERATION_TYPE

CfExecute