Fungsi SeQuerySecurityDescriptorInfo (ntifs.h)
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 |
---|---|
|
Panggilan ke SeQuerySecurityDescriptorInfo berhasil. |
|
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.
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Universal |
Header | ntifs.h (termasuk Ntifs.h) |
Pustaka | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |