Fungsi RtlSetOwnerSecurityDescriptor (ntifs.h)

Artikel
03/08/2023

Rutinitas RtlSetOwnerSecurityDescriptor menetapkan informasi pemilik deskriptor keamanan format absolut. Ini menggantikan informasi pemilik apa pun yang sudah ada di deskriptor keamanan.

Sintaks

NTSYSAPI NTSTATUS RtlSetOwnerSecurityDescriptor(
  [in, out]      PSECURITY_DESCRIPTOR SecurityDescriptor,
  [in, optional] PSID                 Owner,
  [in, optional] BOOLEAN              OwnerDefaulted
);

Parameter

[in, out] SecurityDescriptor

Arahkan ke struktur SECURITY_DESCRIPTOR yang pemiliknya akan ditetapkan. RtlSetOwnerSecurityDescriptor menggantikan pemilik yang ada dengan pemilik baru.

[in, optional] Owner

Penunjuk ke struktur pengidentifikasi keamanan (SID) untuk pemilik utama baru deskriptor keamanan. Penunjuk ini, bukan struktur SID itu sendiri, disalin ke dalam deskriptor keamanan. Jika parameter ini NULL, RtlSetOwnerSecurityDescriptor menghapus informasi pemilik deskriptor keamanan. Ini menandai deskriptor keamanan sebagai tidak memiliki pemilik.

[in, optional] OwnerDefaulted

Atur ke TRUE jika informasi pemilik berasal dari mekanisme default. Jika nilai ini TRUE, nilai tersebut adalah informasi default. RtlSetOwnerSecurityDescriptor mengatur bendera SE_OWNER_DEFAULTED di bidang SECURITY_DESCRIPTOR_CONTROL deskriptor keamanan. Jika parameter ini FALSE, bendera SE_OWNER_DEFAULTED akan dihapus.

Nilai kembali

RtlSetOwnerSecurityDescriptor dapat mengembalikan salah satu kode status berikut:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Pemilik berhasil diatur atau direset.
STATUS_UNKNOWN_REVISION	Versi deskriptor keamanan yang diberikan tidak dikenali oleh rutinitas ini.
STATUS_INVALID_SECURITY_DESCR	Deskriptor keamanan yang diberikan bukan pendeskripsi keamanan absolut yang valid.

Keterangan

Untuk informasi selengkapnya tentang keamanan dan kontrol akses, lihat Model keamanan Windows untuk pengembang driver dan dokumentasi tentang topik ini di Windows SDK.

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Header	ntifs.h (termasuk Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe (mode kernel); Ntdll.dll (mode pengguna)
IRQL	< DISPATCH_LEVEL