Fungsi IoRemoveShareAccess (wdm.h)

  • Artikel

Rutinitas IoRemoveShareAccess menghapus informasi akses dan akses berbagi untuk instans terbuka tertentu dari objek file.

Sintaks

void IoRemoveShareAccess(
  [in]      PFILE_OBJECT  FileObject,
  [in, out] PSHARE_ACCESS ShareAccess
);

Parameter

[in] FileObject

Penunjuk ke objek file, yang biasanya sedang ditutup oleh utas saat ini.

[in, out] ShareAccess

Penunjuk ke struktur akses berbagi yang menjelaskan bagaimana objek file terbuka saat ini sedang diakses.

Nilai kembali

Tidak ada

Keterangan

Rutinitas ini adalah timbal balik dari IoUpdateShareAccess.

IoRemoveShareAccess bukan operasi atomik. Oleh karena itu, driver yang memanggil rutinitas ini harus melindungi objek file bersama yang diteruskan ke IoRemoveShareAccess dengan cara semacam kunci, seperti mutex atau kunci sumber daya, untuk mencegah kerusakan jumlah akses bersama.

Pemanggil IoRemoveShareAccess harus berjalan di IRQL = PASSIVE_LEVEL dan dalam konteks utas yang meminta agar FileObject ditutup.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia dimulai dengan Windows 2000.
Target Platform Universal
Header wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL (lihat bagian Keterangan)
Aturan kepatuhan DDI HwStorPortProhibitedDDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm)

Lihat juga

IoCheckShareAccess

IoSetShareAccess

IoUpdateShareAccess