Fungsi QueryRecoveryAgentsOnEncryptedFile (winefs.h)

Mengambil daftar agen pemulihan untuk file yang ditentukan.

Sintaks

DWORD QueryRecoveryAgentsOnEncryptedFile(
  [in]  LPCWSTR                           lpFileName,
  [out] PENCRYPTION_CERTIFICATE_HASH_LIST *pRecoveryAgents
);

Parameter

[in] lpFileName

Nama file.

[out] pRecoveryAgents

Penunjuk ke struktur ENCRYPTION_CERTIFICATE_HASH_LIST yang menerima daftar agen pemulihan.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan sistem. Untuk daftar lengkap kode kesalahan, lihat Kode Kesalahan Sistem atau file header WinError.h.

Keterangan

Ketika daftar agen pemulihan tidak lagi diperlukan, bebaskan dengan memanggil fungsi FreeEncryptionCertificateHashList .

Di Windows 8, Windows Server 2012, dan yang lebih baru, fungsi ini didukung oleh teknologi berikut.

Teknologi	Didukung
Protokol Server Message Block (SMB) 3.0	Ya
SMB 3.0 Transparent Failover (TFO)	Tidak
SMB 3.0 dengan Scale-out File Shares (SO)	Tidak
Sistem File Volume Bersama Kluster (CsvFS)	Tidak
Sistem File Tangguh (ReFS)	Tidak

 

SMB 3.0 tidak mendukung EFS pada berbagi dengan kemampuan ketersediaan berkelanjutan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	winefs.h (termasuk Windows.h)
Pustaka	Advapi32.lib
DLL	Advapi32.dll
Set API	ext-ms-win-advapi32-encryptedfile-l1-1-1 (diperkenalkan dalam Windows 10, versi 10.0.14393)

Lihat juga

ENCRYPTION_CERTIFICATE_HASH_LIST

Enkripsi File

Fungsi Manajemen File

FreeEncryptionCertificateHashList