Fungsi IoSetLinkShareAccess (wdm.h)

  • Artikel

Rutinitas IoSetLinkShareAccess mengatur hak akses untuk tautan yang berbagi objek file yang ditentukan.

Sintaks

void IoSetLinkShareAccess(
  [in]                ACCESS_MASK        DesiredAccess,
  [in]                ULONG              DesiredShareAccess,
  [in, out]           PFILE_OBJECT       FileObject,
  [in, out]           PSHARE_ACCESS      ShareAccess,
  [in, out, optional] PLINK_SHARE_ACCESS LinkShareAccess,
  [in]                ULONG              IoShareAccessFlags
);

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 ketika permintaan terbuka dibuat. Nilai ini bisa nol, atau kombinasi apa pun dari yang 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, out, optional] LinkShareAccess

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

[in] IoShareAccessFlags

Bitmask dari bendera ini:

IO_SHARE_ACCESS_NO_WRITE_PERMISSION (0x80000000) menentukan bahwa pengguna tidak memiliki izin tulis untuk file tersebut. Bendera ini digunakan untuk mencegah pembukaan file untuk akses baca eksklusif ketika pengguna tidak memiliki izin yang sesuai.

IO_CHECK_SHARE_ACCESS_UPDATE_SHARE_ACCESS (0x00000001) menunjukkan apakah struktur SHARE_ACCESS diperbarui.

Nilai kembali

Tidak ada

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 10 versi 1709
Server minimum yang didukung Server Windows 2016
Target Platform Universal
Header wdm.h
Pustaka Ntoskrnl.lib

Lihat juga

IoCheckLinkShareAccess

IoRemoveLinkShareAccess

IoUpdateLinkShareAccess