cfGetTransferKey 函式 (cfapi.h)
CfGetTransferKey 會傳回 TransferKey，這是使用 CfExecute API 將數據傳輸至佔位符所需的。
語法
HRESULT CfGetTransferKey(
[in] HANDLE FileHandle,
[out] CF_TRANSFER_KEY *TransferKey
);
參數
[in] FileHandle
佔位元的檔案句柄。
[out] TransferKey
要服務之佔位元的不透明句柄。
傳回值
如果函式成功，則會傳 S_OK回 。 否則，它會傳回 HRESULT 錯誤碼。
備註
此 API 適用於想要主動將數據傳輸至佔位元的同步提供者，作為呼叫 CfHydratePlaceholder 的替代方案。 CfGetTransferKey 會傳回擷取數據回呼傳回的相同 TransferKey 。 接著，同步提供者就可以在後續呼叫 CfExecute API 中傳遞 TransferKey。 如此一來，同步提供者會驅動數據傳輸，而不是篩選條件。
同步提供者應該具有 READ_DATA 或 WRITE_DAC 存取要取得其傳輸密鑰的檔案，否則 CfGetTransferKey 將會因為 HRESULT (ERROR_CLOUD_FILE_ACCESS_DENIED) 而失敗。
只要用來取得 TransferKey 的 FileHandle 保持開啟狀態，TransferKey 就有效。 同步提供者必須將 TransferKey 傳遞至 CfExecute ，才能在佔位符檔案或資料夾上執行所需的作業。 當不再使用 TransferKey 時，必須使用 CfReleaseTransferKey 發行它。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 10 版本 1709 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2016 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | cfapi.h |
| 程式庫 | CldApi.lib |
| Dll | CldApi.dll |