Fungsi CfReferenceProtectedHandle (cfapi.h)

Memungkinkan pemanggil untuk mereferensikan handel yang dilindungi ke handel Win32 yang dapat digunakan dengan API non-CfApi Win32.

Sintaks

BOOLEAN CfReferenceProtectedHandle(
  [in] HANDLE ProtectedHandle
);

Parameter

[in] ProtectedHandle

Handel yang dilindungi dari file tempat penampung.

Mengembalikan nilai

Jika fungsi ini berhasil, fungsi akan mengembalikan TRUE. Jika tidak, ia kembali FALSE.

Keterangan

Setiap panggilan CfReferenceProtectedHandle harus dicocokkan dengan panggilan CfReleaseProtectedHandle . Tidak disarankan untuk mereferensikan handel yang dilindungi untuk jangka waktu yang lama, karena itu akan mencegah pemberitahuan pemutusan oplock diakui.

Penelepon seharusnya memecah tugas yang berjalan lama menjadi sub-tugas yang lebih kecil dan mereferensikan/melepaskan handel yang dilindungi untuk setiap sub-tugas.

Persyaratan

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

CfReleaseProtectedHandle