Fungsi SeQuerySecurityDescriptorInfo (ntifs.h)

Artikel
02/29/2024

Rutinitas SeQuerySecurityDescriptorInfo mengambil salinan deskriptor keamanan objek.

Sintaks

NTSTATUS SeQuerySecurityDescriptorInfo(
  [in]      PSECURITY_INFORMATION SecurityInformation,
  [out]     PSECURITY_DESCRIPTOR  SecurityDescriptor,
  [in, out] PULONG                Length,
  [in, out] PSECURITY_DESCRIPTOR  *ObjectsSecurityDescriptor
);

Parameter

[in] SecurityInformation

Penunjuk ke nilai SECURITY_INFORMATION yang menentukan informasi keamanan mana yang sedang dikueri.

Nilai	Makna
DACL_SECURITY_INFORMATION	Menunjukkan daftar kontrol akses diskresi (DACL) objek sedang dikueri. Membutuhkan akses READ_CONTROL.
GROUP_SECURITY_INFORMATION	Menunjukkan pengidentifikasi grup utama objek sedang dikueri. Membutuhkan akses READ_CONTROL.
OWNER_SECURITY_INFORMATION	Menunjukkan pengidentifikasi pemilik objek sedang dikueri. Membutuhkan akses READ_CONTROL.
SACL_SECURITY_INFORMATION	Menunjukkan sistem ACL (SACL) objek sedang dikueri. Membutuhkan akses ACCESS_SYSTEM_SECURITY.

[out] SecurityDescriptor

Buffer pengguna yang dialokasikan pemanggil yang diisi SeQuerySecurityDescriptorInfo dengan salinan deskriptor keamanan yang ditentukan dalam format relatif mandiri.

[in, out] Length

Penunjuk ke variabel yang menentukan ukuran, dalam byte, dari buffer yang diacu oleh SecurityDescriptor. Setelah dikembalikan, SeQuerySecurityDescriptorInfo mengatur variabel ini ke jumlah byte yang diperlukan untuk menyimpan informasi yang diminta.

[in, out] ObjectsSecurityDescriptor

Penunjuk ke penunjuk ke deskriptor keamanan objek. Deskriptor keamanan harus dalam format relatif mandiri.

Mengembalikan nilai

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Panggilan ke SeQuerySecurityDescriptorInfo berhasil.
STATUS_BUFFER_TOO_SMALL	Buffer terlalu kecil untuk deskriptor keamanan. Tidak ada informasi keamanan yang disalin ke penyangga.

Keterangan

Deskriptor keamanan dapat dalam format absolut atau relatif mandiri. 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.

Karena deskriptor keamanan dikembalikan dalam format relatif mandiri, pemanggil SeQuerySecurityDescriptorInfo harus mentransmisikan nilai yang dikembalikan dalam parameter SecurityDescriptor untuk mengetik PISECURITY_DESCRIPTOR_RELATIVE.

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