ioSetLinkShareAccess 函数 (wdm.h)

IoSetLinkShareAccess 例程设置共享指定文件对象的链接的访问权限。

语法

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
);

参数

[in] DesiredAccess

指定一个 ACCESS_MASK 值,该值指示对给定文件对象的所需访问类型。

[in] DesiredShareAccess

为当前打开的请求指定对文件对象的所需共享访问类型。 此参数的值通常与在发出打开请求时由 I/O 管理器传递给文件系统或最高级别驱动程序的 ShareAccess 参数相同。 此值可以是零,也可以是以下任意组合:

FILE_SHARE_READ

FILE_SHARE_WRITE

FILE_SHARE_DELETE

[in, out] FileObject

指向要为其检查当前打开请求的访问权限的文件对象的指针。

[in, out] ShareAccess

指向与 FileObject 关联的常见共享访问数据结构的指针。 驱动程序应将此结构视为不透明。

[in, out, optional] LinkShareAccess

指向与 FileObject 关联的公共链接共享访问数据结构的指针 (LINK_SHARE_ACCESS) 。 驱动程序应将此结构视为不透明。

[in] IoShareAccessFlags

这些标志的位掩码:

IO_SHARE_ACCESS_NO_WRITE_PERMISSION (0x80000000) 指定用户对文件没有写入权限。 当用户没有相应权限时,此标志用于阻止打开文件进行独占读取访问。

IO_CHECK_SHARE_ACCESS_UPDATE_SHARE_ACCESS (0x00000001) 指示是否更新SHARE_ACCESS结构。

返回值

要求

要求
最低受支持的客户端 Windows 10 版本 1709
最低受支持的服务器 Windows Server 2016
目标平台 通用
标头 wdm.h
Library Ntoskrnl.lib

另请参阅

IoCheckLinkShareAccess

IoRemoveLinkShareAccess

IoUpdateLinkShareAccess