Fungsi FltBuildDefaultSecurityDescriptor (fltkernel.h)

Artikel
02/26/2024

FltBuildDefaultSecurityDescriptor membangun deskriptor keamanan default untuk digunakan dengan FltCreateCommunicationPort.

Sintaks

NTSTATUS FLTAPI FltBuildDefaultSecurityDescriptor(
  [out] PSECURITY_DESCRIPTOR *SecurityDescriptor,
  [in]  ACCESS_MASK          DesiredAccess
);

Parameter

[out] SecurityDescriptor

Penunjuk ke variabel yang dialokasikan pemanggil yang menerima penunjuk buram ke SECURITY_DESCRIPTOR yang baru dibuat.

[in] DesiredAccess

Bitmask bendera yang menentukan jenis akses yang diperlukan pemanggil ke objek port. Kumpulan bendera DesiredAccess yang ditentukan sistem menentukan hak akses khusus berikut untuk objek port komunikasi driver minifilter.

Bendera DesiredAccess	Makna
FLT_PORT_CONNECT	Pemanggil dapat tersambung ke port.
FLT_PORT_ALL_ACCESS	FLT_PORT_CONNECT \| STANDARD_RIGHTS_ALL

Nilai kembali

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

Menampilkan kode	Deskripsi
STATUS_INSUFFICIENT_RESOURCES	FltBuildDefaultSecurityDescriptor mengalami kegagalan alokasi kumpulan. Ini adalah kode kesalahan.

Keterangan

Saat membuat port komunikasi driver minifilter, driver minifilter dapat memanggil FltBuildDefaultSecurityDescriptor untuk membuat deskriptor keamanan default untuk port. Driver minifilter kemudian membuat port dengan memanggil InitializeObjectAttributes dan FltCreateCommunicationPort. Deskriptor keamanan diteruskan sebagai parameter ke InitializeObjectAttributes.

FltBuildDefaultSecurityDescriptor menyebabkan sistem mengalokasikan deskriptor keamanan default dari kumpulan halaman. Ketika deskriptor keamanan ini diterapkan ke objek, hanya pengguna dengan hak istimewa sistem atau administrator yang memiliki akses ke objek.

Driver minifilter biasanya memanggil FltBuildDefaultSecurityDescriptor segera sebelum memanggil FltCreateCommunicationPort dan FltFreeSecurityDescriptor segera setelah memanggil FltCreateCommunicationPort.