Fungsi IoCheckFunctionAccess (ntifs.h)

Artikel
02/26/2024

IoCheckFunctionAccess rutin memeriksa parameter dan akses untuk fungsi terhadap akses yang diberikan saat ini ke file.

Sintaks

NTSTATUS IoCheckFunctionAccess(
  ACCESS_MASK GrantedAccess,
  UCHAR       MajorFunction,
  UCHAR       MinorFunction,
  ULONG       IoControlCode,
  PVOID       Arg1,
  PVOID       Arg2
);

Parameter

GrantedAccess

Nilai masker yang menentukan akses yang saat ini diberikan ke file untuk pemanggil.

MajorFunction

Kode fungsi utama untuk operasi yang sedang dilakukan.

MinorFunction

Kode fungsi kecil untuk operasi yang sedang dilakukan.

IoControlCode

Kode kontrol fungsi I/O untuk perangkat atau kode I/O sistem file.

Arg1

Argumen opsional yang bergantung pada fungsi utama. Parameter ini menunjuk ke salah satu nilai enum FILE_INFORMATION_CLASS jika MajorFunction menunjukkan fungsi informasi file kueri atau set sedang dilakukan.

Arg2

Argumen kedua opsional yang bergantung pada fungsi utama. Parameter ini menunjuk ke salah satu nilai enum FS_INFORMATION_CLASS . Parameter ini harus disediakan jika MajorFunction menunjukkan fungsi informasi file kueri atau set sedang dilakukan.

Mengembalikan nilai

IoCheckFunctionAccess mengembalikan STATUS_SUCCESS jika pemanggil memiliki akses ke file; jika tidak, ia mengembalikan STATUS_ACCESS_DENIED.

Keterangan

Masker GrantedAccess tidak boleh berisi pemetaan generik apa pun. Artinya, IoCheckDesiredAccess sebelumnya harus dipanggil untuk mengembalikan topeng penuh.