Fungsi DuplicateEncryptionInfoFile (winefs.h)

Artikel
08/27/2023

Menyalin metadata EFS dari satu file atau direktori ke file lainnya.

Sintaks

DWORD DuplicateEncryptionInfoFile(
  [in]           LPCWSTR                     SrcFileName,
  [in]           LPCWSTR                     DstFileName,
  [in]           DWORD                       dwCreationDistribution,
  [in]           DWORD                       dwAttributes,
  [in, optional] const LPSECURITY_ATTRIBUTES lpSecurityAttributes
);

Parameter

[in] SrcFileName

Nama file atau direktori tempat metadata EFS akan disalin. File atau direktori sumber ini harus dienkripsi.

[in] DstFileName

Nama file atau direktori tempat metadata EFS akan disalin.

File atau direktori tujuan ini tidak harus dienkripsi sebelum panggilan ke fungsi ini; namun jika fungsi ini berhasil diselesaikan, fungsi ini akan dienkripsi.

Jika nilai SrcFileName menentukan file, nilai parameter ini juga harus menentukan file, dan juga untuk direktori. Jika file atau direktori dengan nama yang ditentukan oleh parameter ini tidak ada, file atau direktori (tergantung pada apakah SrcFileName menentukan file atau direktori) akan dibuat.

[in] dwCreationDistribution

Menjelaskan bagaimana file tujuan atau direktori yang diidentifikasi oleh nilai parameter DstFileName akan dibuka. Berikut ini adalah nilai yang valid dari parameter ini.

Nilai	Makna
CREATE_ALWAYS 2	Selalu buat file atau direktori tujuan. Nilai apa pun yang diteruskan dalam parameter ini selain CREATE_NEW akan diproses sebagai CREATE_ALWAYS.
CREATE_NEW 1	Buat file atau direktori tujuan hanya jika belum ada. Jika memang ada, dan nilai ini ditentukan, fungsi ini akan gagal.

[in] dwAttributes

Atribut file dari file atau direktori tujuan. Atribut FILE_READ_ONLY saat ini tidak diproses oleh fungsi ini.

[in, optional] lpSecurityAttributes

Penunjuk ke struktur SECURITY_ATTRIBUTES yang menentukan atribut keamanan file atau direktori tujuan, jika belum ada. Jika Anda menentukan NULL, file atau direktori akan mendapatkan deskriptor keamanan default. ACL dalam deskriptor keamanan default untuk file atau direktori diwarisi dari direktori induknya.

Nilai kembali

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

Akses eksklusif ke file atau direktori tujuan diperlukan oleh EFS untuk panggilan ke fungsi ini. Jika akses ini tidak disediakan, fungsi ini akan gagal.

Pemanggil harus memiliki kunci EFS untuk file atau direktori sumber, dan setidaknya READ_ATTRIBUTE ACL untuk file atau direktori sumber.

File atau direktori sumber dan tujuan yang ditentukan harus berada di komputer yang sama; jika tidak, kesalahan akan dikembalikan.

Di Windows 8 dan Windows Server 2012, 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 Berbagi File Peluasan Skala (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


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

Lihat juga

Enkripsi File

Fungsi Manajemen File

SECURITY_ATTRIBUTES

Share via