struktur CF_PLACEHOLDER_CREATE_INFO (cfapi.h)

Berisi informasi tempat penampung untuk membuat file atau direktori tempat penampung baru.

Sintaks

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;

Anggota

RelativeFileName

Nama file atau direktori tempat penampung anak yang akan dibuat. Ini seharusnya hanya terdiri dari nama file atau direktori.

Misalnya, jika akar sinkronisasi penyedia adalah C:\SyncRoot maka untuk membuat tempat penampung bernama placeholder.txt di subdirektori akar sinkronisasi, panggil fungsi CfCreatePlaceholders dengan BaseDirectoryPath sama dengan C:\SyncRoot\SubDirectory dan atur bidang RelativePathNamedari CF_PLACEHOLDER_CREATE_INFO ke placeholder.txt.

FsMetadata

Metadata sistem file yang akan dibuat dengan tempat penampung, termasuk semua tanda waktu, atribut file, dan ukuran file (opsional untuk direktori).

FileIdentity

Buffer mode pengguna yang berisi informasi file yang disediakan oleh penyedia sinkronisasi. Blob FileIdentity tidak boleh melebihi ukuran CF_PLACEHOLDER_MAX_FILE_IDENTITY_LENGTH (didefinisikan hingga 4KB). FileIdentity akan diteruskan kembali ke penyedia sinkronisasi di semua panggilan balik. Ini diperlukan untuk file (bukan untuk direktori).

FileIdentityLength

Panjang, dalam byte, dari FileIdentity.

Flags

Bendera untuk menentukan perilaku pembuatan tempat penampung. Lihat CF_PLACEHOLDER_CREATE_FLAGS untuk informasi selengkapnya.

Result

Hasil pembuatan tempat penampung. Pada pembuatan yang berhasil, nilainya STATUS_OK.

CreateUsn

Nilai USN akhir setelah membuat tindakan dilakukan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10, versi 1709 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2016 [hanya aplikasi desktop]
Header	cfapi.h

Lihat juga

CF_PLACEHOLDER_CREATE_FLAGS

CfCreatePlaceholders