Fungsi SetFileSecurityA (winbase.h)

Artikel
03/09/2024

Fungsi SetFileSecurity mengatur keamanan file atau objek direktori.

Fungsi ini usang. Gunakan fungsi SetNamedSecurityInfo sebagai gantinya.

Sintaks

BOOL SetFileSecurityA(
  [in] LPCSTR               lpFileName,
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);

Parameter

[in] lpFileName

Penunjuk ke string yang dihentikan null yang menentukan file atau direktori tempat keamanan diatur. Perhatikan bahwa keamanan yang diterapkan ke direktori tidak diwariskan oleh turunannya.

[in] SecurityInformation

Menentukan struktur SECURITY_INFORMATION yang mengidentifikasi konten deskriptor keamanan yang diarahkan oleh parameter pSecurityDescriptor .

[in] pSecurityDescriptor

Penunjuk ke struktur SECURITY_DESCRIPTOR .

Nilai kembali

Jika fungsi berhasil, fungsi mengembalikan bukan nol.

Jika fungsi gagal, fungsi akan mengembalikan nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Fungsi SetFileSecurity berhasil hanya jika kondisi berikut terpenuhi:

Jika pemilik objek sedang diatur, proses panggilan harus memiliki izin WRITE_OWNER atau menjadi pemilik objek.
Jika daftar kontrol akses diskresi (DACL) objek sedang diatur, proses panggilan harus memiliki izin WRITE_DAC atau menjadi pemilik objek.
Jika daftar kontrol akses sistem (SACL) objek sedang diatur, hak istimewa SE_SECURITY_NAME harus diaktifkan untuk proses panggilan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	winbase.h (termasuk Windows.h)
Pustaka	Advapi32.lib
DLL	Advapi32.dll