Fungsi FltSetSecurityObject (fltkernel.h)

Artikel
08/07/2023

FltSetSecurityObject menetapkan status keamanan objek.

Sintaks

NTSTATUS FLTAPI FltSetSecurityObject(
  [in] PFLT_INSTANCE        Instance,
  [in] PFILE_OBJECT         FileObject,
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR SecurityDescriptor
);

Parameter

[in] Instance

Penunjuk instans buram untuk pemanggil. Parameter ini diperlukan dan tidak boleh NULL.

[in] FileObject

Penunjuk objek file untuk objek yang status keamanannya akan diatur. Pemanggil harus memiliki akses yang ditentukan di kolom Arti tabel yang diperlihatkan dalam deskripsi parameter SecurityInformation . Parameter ini diperlukan dan tidak boleh NULL.

[in] SecurityInformation

SECURITY_INFORMATION nilai yang menentukan informasi yang akan ditetapkan sebagai kombinasi dari satu atau beberapa hal berikut ini.

Nilai	Makna
OWNER_SECURITY_INFORMATION	Menunjukkan pengidentifikasi pemilik objek akan diatur. Memerlukan akses WRITE_OWNER.
GROUP_SECURITY_INFORMATION	Menunjukkan pengidentifikasi grup utama objek yang akan diatur. Memerlukan akses WRITE_OWNER.
DACL_SECURITY_INFORMATION	Menunjukkan daftar kontrol akses diskresi (DACL) objek yang akan diatur. Membutuhkan akses WRITE_DAC.
SACL_SECURITY_INFORMATION	Menunjukkan sistem ACL (SACL) objek yang akan diatur. Memerlukan akses ACCESS_SYSTEM_SECURITY.

[in] SecurityDescriptor

Arahkan ke deskriptor keamanan yang akan diatur untuk objek.

Nilai kembali

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

Menampilkan kode	Deskripsi
STATUS_ACCESS_DENIED	Penelepon tidak memiliki akses yang diperlukan. Ini adalah kode kesalahan.
STATUS_ACCESS_VIOLATION	SecurityDescriptor adalah penunjuk NULL . Ini adalah kode kesalahan.
STATUS_INSUFFICIENT_RESOURCES	Deskriptor keamanan objek tidak dapat ditangkap. Ini adalah kode kesalahan.
STATUS_INVALID_ACL	Deskriptor keamanan objek berisi ACL yang tidak valid. Ini adalah kode kesalahan.
STATUS_INVALID_SECURITY_DESCR	SecurityDescriptor tidak menunjuk ke pendeskripsi keamanan yang valid. Ini adalah kode kesalahan.
STATUS_INVALID_SID	Deskriptor keamanan objek berisi SID yang tidak valid. Ini adalah kode kesalahan.
STATUS_UNKNOWN_REVISION	Tingkat revisi deskriptor keamanan objek tidak diketahui atau tidak didukung. Ini adalah kode kesalahan.
STATUS_NOT_IMPLEMENTED	Rutinitas FltSetSecurityObject ada tetapi tidak didukung di lingkungan sistem operasi di mana ia dipanggil.

Keterangan

Rutinitas FltSetSecurityObject hadir dan didukung dimulai dengan Windows Vista. Di Windows 2000, Windows XP, dan Server 2003 SP1, rutinitas ada tetapi tidak didukung, dan akan mengembalikan STATUS_NOT_IMPLEMENTED jika dipanggil di salah satu lingkungan ini.

Deskriptor keamanan dapat dalam bentuk absolut atau relatif mandiri. Dalam bentuk relatif mandiri, semua anggota struktur terletak bersebelahan dalam memori. Dalam bentuk absolut, struktur hanya berisi penunjuk ke anggota. Untuk informasi selengkapnya, lihat Deskriptor Keamanan Absolut dan Self-Relative.

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