Fungsi CfRevertPlaceholder (cfapi.h)

Mengembalikan tempat penampung kembali ke file biasa, menghapus semua karakteristik khusus seperti tag pemilahan ulang, identitas file, dll.

Sintaks

HRESULT CfRevertPlaceholder(
  [in]                HANDLE          FileHandle,
  [in]                CF_REVERT_FLAGS RevertFlags,
  [in, out, optional] LPOVERLAPPED    Overlapped
);

Parameter

[in] FileHandle

Handel ke tempat penampung file atau direktori yang akan dikembalikan ke file atau direktori normal. Platform ini menyinkronkan operasi kembali dengan benar dengan permintaan aktif lainnya. Atribut atau handel tanpa akses sudah cukup.

[in] RevertFlags

Tempat penampung mengembalikan bendera. RevertFlags harus diatur ke CF_REVERT_FLAG_NONE.

[in, out, optional] Overlapped

Ketika ditentukan dan dikombinasikan dengan FileHandle asinkron, Tumpang tindih memungkinkan platform untuk melakukan panggilan CfRevertPlaceholder secara asinkron. Lihat Keterangan untuk detail selengkapnya.

Jika tidak ditentukan, platform akan melakukan panggilan API secara sinkron, terlepas dari bagaimana handel dibuat.

Menampilkan nilai

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Penelepon harus memiliki akses WRITE_DATA atau WRITE_DAC ke tempat penampung untuk dikembalikan.

Jika tempat penampung belum sepenuhnya terhidrasi pada saat panggilan, filter akan mengirim panggilan balik FETCH_DATA ke penyedia sinkronisasi untuk menghidrasi file. Jika file tidak dapat dihidrasi, kembalikan akan gagal dengan status STATUS_CLOUD_FILE_ACCESS_DENIED.

Jika API mengembalikan HRESULT_FROM_WIN32(ERROR_IO_PENDING) saat menggunakan Tumpang Tindih secara asinkron, pemanggil kemudian dapat menunggu menggunakan GetOverlappedResult.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10, versi 1709 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2016 [hanya aplikasi desktop]
Target Platform	Windows
Header	cfapi.h
Pustaka	CldApi.lib
DLL	CldApi.dll

Lihat juga

GetOverlappedResult

CF_REVERT_FLAGS