CF_PLACEHOLDER_CREATE_INFO 結構 (cfapi.h)
包含用來建立新佔位元檔案或目錄的佔位元元資訊。
語法
typedef struct CF_PLACEHOLDER_CREATE_INFO {
LPCWSTR RelativeFileName;
CF_FS_METADATA FsMetadata;
LPCVOID FileIdentity;
DWORD FileIdentityLength;
CF_PLACEHOLDER_CREATE_FLAGS Flags;
HRESULT Result;
USN CreateUsn;
} CF_PLACEHOLDER_CREATE_INFO;
成員
RelativeFileName
要建立之子佔位元檔案或目錄的名稱。 它應該只包含檔案或目錄名稱。
例如，如果提供者的同步根目錄是 C：\SyncRoot，則若要在同步根目錄的子目錄中建立名為 placeholder.txt 的佔位元，請使用 BaseDirectoryPath 等於 C:\SyncRoot\SubDirectory呼叫 CfCreatePlaceholders 函式，並將CF_PLACEHOLDER_CREATE_INFO的 RelativePathName 字段設定為 placeholder.txt。
FsMetadata
要以佔位元建立的文件系統元數據，包括所有時間戳、檔案屬性和檔案大小， (目錄) 選擇性。
FileIdentity
使用者模式緩衝區，包含同步提供者所提供的檔案資訊。 FileIdentity Blob 不應超過定義為大小為 4KB) CF_PLACEHOLDER_MAX_FILE_IDENTITY_LENGTH (。 FileIdentity 會傳回所有回呼中的同步提供者。 檔案 (不是目錄) 的必要專案。
FileIdentityLength
FileIdentity 的長度，以位元組為單位。
Flags
用於指定佔位元建立行為的旗標。 如需詳細資訊 ，請參閱CF_PLACEHOLDER_CREATE_FLAGS 。
Result
佔位元建立的結果。 成功建立時，值會 STATUS_OK。
CreateUsn
執行建立動作之後的最終 USN 值。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 10 1709 版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2016 [僅限傳統型應用程式] |
| 標頭 | cfapi.h |