Fungsi MakeSelfRelativeSD (securitybaseapi.h)

Fungsi MakeSelfRelativeSD membuat deskriptor keamanan dalam format relatif mandiri dengan menggunakan deskriptor keamanan dalam format absolut sebagai templat.

Sintaks

BOOL MakeSelfRelativeSD(
  [in]            PSECURITY_DESCRIPTOR pAbsoluteSecurityDescriptor,
  [out, optional] PSECURITY_DESCRIPTOR pSelfRelativeSecurityDescriptor,
  [in, out]       LPDWORD              lpdwBufferLength
);

Parameter

[in] pAbsoluteSecurityDescriptor

Penunjuk ke struktur SECURITY_DESCRIPTOR dalam format absolut. Fungsi ini membuat versi deskriptor keamanan ini dalam format relatif mandiri tanpa memodifikasi aslinya.

[out, optional] pSelfRelativeSecurityDescriptor

Penunjuk ke buffer fungsi diisi dengan deskriptor keamanan dalam format relatif mandiri.

[in, out] lpdwBufferLength

Penunjuk ke variabel yang menentukan ukuran buffer yang diacu oleh parameter pSelfRelativeSD . Jika buffer tidak cukup besar untuk deskriptor keamanan, fungsi gagal dan mengatur variabel ini ke ukuran minimum yang diperlukan.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError. Kemungkinan kode pengembalian termasuk, tetapi tidak terbatas pada, berikut ini.

Mengembalikan kode/nilai	Deskripsi
ERROR_INSUFFICIENT_BUFFER 0x7A	Satu atau beberapa buffer terlalu kecil.

Keterangan

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

Server yang menyalin objek aman ke berbagai media dapat menggunakan fungsi MakeSelfRelativeSD untuk membuat deskriptor keamanan relatif mandiri dari deskriptor keamanan absolut dan fungsi MakeAbsoluteSD untuk membuat deskriptor keamanan absolut dari deskriptor keamanan relatif mandiri.

Persyaratan

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

Lihat juga

Access Control tingkat rendah

Fungsi Access Control tingkat rendah

MakeAbsoluteSD

SECURITY_DESCRIPTOR