Fungsi IoCheckShareAccessEx (wdm.h)

Rutinitas IoCheckShareAccessEx dipanggil oleh driver sistem file (FSD) atau driver tingkat tertinggi lainnya untuk memeriksa apakah akses bersama ke objek file diizinkan.

Sintaks

NTSTATUS IoCheckShareAccessEx(
  [in]      ACCESS_MASK   DesiredAccess,
  [in]      ULONG         DesiredShareAccess,
  [in, out] PFILE_OBJECT  FileObject,
  [in, out] PSHARE_ACCESS ShareAccess,
  [in]      BOOLEAN       Update,
  [in]      PBOOLEAN      WritePermission
);

Parameter

[in] DesiredAccess

Menentukan nilai ACCESS_MASK yang menunjukkan jenis akses yang diinginkan ke objek file yang diberikan.

[in] DesiredShareAccess

Menentukan jenis akses bersama yang diinginkan ke objek file untuk permintaan terbuka saat ini. Nilai parameter ini biasanya sama dengan parameter ShareAccess yang diteruskan ke sistem file atau driver tingkat tertinggi oleh manajer I/O saat permintaan terbuka dibuat. Nilai ini bisa nol, atau kombinasi apa pun dari berikut ini:

FILE_SHARE_READ

FILE_SHARE_WRITE

FILE_SHARE_DELETE

[in, out] FileObject

Penunjuk ke objek file yang akan memeriksa akses untuk permintaan terbuka saat ini.

[in, out] ShareAccess

Penunjuk ke struktur data akses berbagi umum yang terkait dengan FileObject. Driver harus memperlakukan struktur ini sebagai buram.

[in] Update

Menentukan apakah akan memperbarui status akses berbagi untuk FileObject. Nilai Boolean TRUE berarti rutinitas ini akan memperbarui informasi akses berbagi untuk objek file jika permintaan terbuka diizinkan.

[in] WritePermission

Menentukan apakah akses berbagi memiliki izin tulis. Nilai ini TRUE jika berbagi memiliki izin tulis; jika tidak, FALSE. Jika nilainya FALSE dan akses berbagi memiliki izin tulis dan pemanggil mencoba untuk mengambil akses baca eksklusif, izin tulis diturunkan ke FILE_SHARE_READ. Nilai ini adalah NULL jika pemeriksaan izin tulis tidak dilakukan pada akses berbagi.

Nilai kembali

Rutinitas IoCheckShareAccessEx mengembalikan STATUS_SUCCESS jika akses pemohon ke objek file kompatibel dengan cara saat ini terbuka. Jika permintaan ditolak karena pelanggaran berbagi, maka STATUS_SHARING_VIOLATION dikembalikan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows 7 dan versi Windows yang lebih baru.
Target Platform	Universal
Header	wdm.h
Pustaka	Ntoskrnl.lib

Lihat juga

Rutinitas Manajer I/O