Fungsi RtlSetDaclSecurityDescriptor (wdm.h)

Artikel
08/08/2023

Rutinitas RtlSetDaclSecurityDescriptor mengatur informasi DACL dari deskriptor keamanan berformat absolut, atau jika sudah ada DACL yang ada di deskriptor keamanan, itu digantikan.

Sintaks

NTSYSAPI NTSTATUS RtlSetDaclSecurityDescriptor(
  [in, out]      PSECURITY_DESCRIPTOR SecurityDescriptor,
  [in]           BOOLEAN              DaclPresent,
  [in, optional] PACL                 Dacl,
  [in, optional] BOOLEAN              DaclDefaulted
);

Parameter

[in, out] SecurityDescriptor

Penunjuk ke struktur SECURITY_DESCRIPTOR . Struktur ini adalah deskriptor keamanan tempat DACL akan diterapkan.

[in] DaclPresent

Apakah akan menunjukkan bahwa DACL ada dalam deskriptor keamanan. Jika parameter ini FALSE, RtlSetDaclSecurityDescriptor mengatur bendera kontrol SE_DACL_PRESENT di deskriptor keamanan ke FALSE. Dalam hal ini, parameter opsional yang tersisa (Dacl dan DaclDefaulted) diabaikan. Jika DaclPresentTRUE, bendera SE_DACL_PRESENT di deskriptor keamanan diatur ke TRUE dan parameter opsional yang tersisa tidak diabaikan. Untuk informasi selengkapnya tentang bendera SE_DACL_PRESENT, lihat SECURITY_DESCRIPTOR_CONTROL.

[in, optional] Dacl

Penunjuk ke DACL untuk deskriptor keamanan. Jika parameter ini NULL, penunjuk DACL dalam deskriptor keamanan diatur ke NULL. Pointer NULL DACL secara tanpa syarat memberikan semua akses ke objek dan tidak sama dengan DACL kosong. DACL kosong menolak semua akses ke objek. Jika Dacl bukan NULL, struktur ACL yang disediakan oleh pemanggil direferensikan oleh, tetapi tidak disalin ke dalam, pendeskripsi keamanan. Pemanggil dapat mengalokasikan struktur ACL dari memori sistem halaman, dan dapat memanggil rutinitas RtlCreateAcl untuk menginisialisasi struktur.

[in, optional] DaclDefaulted

Apakah DACL disediakan oleh beberapa mekanisme default, atau secara eksplisit ditentukan oleh pemanggil. Jika parameter ini TRUE, DACL disediakan oleh mekanisme default. Jika DaclDefaultedadalah FALSE, pemanggil secara eksplisit menentukan DACL. RtlSetDaclSecurityDescriptor menyalin nilai yang ditentukan untuk parameter ini ke bendera kontrol SE_DACL_DEFAULTED di deskriptor keamanan. Untuk informasi selengkapnya tentang bendera SE_DACL_DEFAULTED, lihat SECURITY_DESCRIPTOR_CONTROL.

Nilai kembali

RtlSetDaclSecurityDescriptor dapat mengembalikan salah satu nilai status berikut.

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Panggilan berhasil diselesaikan.
STATUS_UNKNOWN_REVISION	Revisi deskriptor keamanan tidak diketahui.
STATUS_INVALID_SECURITY_DESCR	Deskriptor keamanan bukan deskriptor keamanan format absolut.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia dimulai dengan Windows 2000.
Target Platform	Universal
Header	wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe (mode kernel); Ntdll.dll (mode pengguna)
IRQL	PASSIVE_LEVEL