Fungsi RtlAbsoluteToSelfRelativeSD (ntifs.h)

Artikel
02/29/2024

Rutinitas RtlAbsoluteToSelfRelativeSD membuat deskriptor keamanan baru dalam format relatif mandiri dengan menggunakan deskriptor keamanan dalam format absolut sebagai templat.

Sintaks

NTSYSAPI NTSTATUS RtlAbsoluteToSelfRelativeSD(
  [in]      PSECURITY_DESCRIPTOR AbsoluteSecurityDescriptor,
  [out]     PSECURITY_DESCRIPTOR SelfRelativeSecurityDescriptor,
  [in, out] PULONG               BufferLength
);

Parameter

[in] AbsoluteSecurityDescriptor

Penunjuk ke buffer yang dialokasikan penelepon yang berisi struktur SECURITY_DESCRIPTOR dalam format absolut. RtlAbsoluteToSelfRelativeSD membuat versi deskriptor keamanan ini dalam format relatif mandiri tanpa memodifikasi yang asli.

[out] SelfRelativeSecurityDescriptor

Penunjuk ke buffer yang dialokasikan penelepon yang menerima deskriptor keamanan dalam format relatif mandiri.

[in, out] BufferLength

Penunjuk ke variabel yang dialokasikan penelepon yang menentukan ukuran, dalam byte, dari buffer yang ditunjukkan oleh parameter SelfRelativeSecurityDescriptor . Jika buffer tidak cukup besar untuk menahan deskriptor keamanan, RtlAbsoluteToSelfRelativeSD mengembalikan STATUS_BUFFER_TOO_SMALL dan mengatur variabel ini ke ukuran minimum yang diperlukan.

Nilai kembali

RtlAbsoluteToSelfRelativeSD mengembalikan STATUS_SUCCESS atau nilai NTSTATUS yang sesuai seperti salah satu hal berikut ini:

Menampilkan kode	Deskripsi
STATUS_BAD_DESCRIPTOR_FORMAT	Buffer yang diarahkan oleh parameter AbsoluteSecurityDescriptor tidak berisi struktur SECURITY_DESCRIPTOR dalam format absolut. STATUS_BAD_DESCRIPTOR_FORMAT adalah kode kesalahan.
STATUS_BUFFER_TOO_SMALL	Buffer yang ditunjukkan oleh parameter SelfRelativeSecurityDescriptor terlalu kecil untuk berisi deskriptor keamanan dalam format relatif mandiri. STATUS_BUFFER_TOO_SMALL adalah kode kesalahan.

Keterangan

Deskriptor keamanan dalam format absolut berisi pointer ke informasi yang dikandungnya, daripada berisi informasi itu sendiri. Deskriptor keamanan dalam format relatif mandiri berisi informasi dalam blok memori yang bersebelahan. Dalam deskriptor keamanan relatif mandiri, struktur SECURITY_DESCRIPTOR selalu memulai informasi, tetapi deskriptor keamanan komponen lain dapat mengikuti struktur SECURITY_DESCRIPTOR dalam urutan apa pun. Alih-alih menggunakan alamat memori, komponen deskriptor keamanan diidentifikasi oleh offset dari awal pendeskripsi keamanan. Format ini berguna ketika deskriptor keamanan harus disimpan pada disk atau ditransmisikan melalui protokol komunikasi.

Untuk membuat deskriptor keamanan baru dalam format absolut dengan menggunakan deskriptor keamanan dalam format relatif mandiri sebagai templat, gunakan RtlSelfRelativeToAbsoluteSD.

Untuk informasi selengkapnya tentang keamanan dan kontrol akses, lihat dokumentasi Microsoft Windows SDK.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Server 2003 SP1
Target Platform	Universal
Header	ntifs.h (termasuk Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe (mode kernel); Ntdll.dll (mode pengguna)
IRQL	<= APC_LEVEL