Fungsi CfGetSyncRootInfoByHandle (cfapi.h)

2024-02-28

Mendapatkan berbagai karakteristik akar sinkronisasi yang berisi file tertentu yang ditentukan oleh handel file.

Sintaks

HRESULT CfGetSyncRootInfoByHandle(
  [in]            HANDLE                  FileHandle,
  [in]            CF_SYNC_ROOT_INFO_CLASS InfoClass,
  [out]           PVOID                   InfoBuffer,
  [in]            DWORD                   InfoBufferLength,
  [out, optional] DWORD                   *ReturnedLength
);

Parameter

[in] FileHandle

Menangani file di bawah akar sinkronisasi yang informasinya akan dikueri.

[in] InfoClass

Jenis informasi akar sinkronisasi.

[out] InfoBuffer

Penunjuk ke buffer yang akan menerima informasi akar sinkronisasi.

[in] InfoBufferLength

Panjang, dalam byte, dari InfoBuffer.

[out, optional] ReturnedLength

Jumlah byte yang dikembalikan di InfoBuffer.

Nilai kembali

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

Keterangan

Tidak seperti kebanyakan API tempat penampung yang mengambil handel file, yang ini tidak memodifikasi file dengan cara apa pun, oleh karena itu FileHandle hanya memerlukan akses READ_ATTRIBUTES .

Jika file tidak berada di bawah akar sinkronisasi file cloud, API akan gagal. Jika berhasil, informasi dikembalikan sesuai dengan InfoClass tertentu yang diminta.

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

CfGetSyncRootInfoByPath

Bagikan melalui