IoRemoveLinkShareAccess 函数 (wdm.h)

  • 项目

IoRemoveLinkShareAccess 例程删除文件对象的给定打开实例的访问和链接共享访问信息。

语法

void IoRemoveLinkShareAccess(
  [in]                PFILE_OBJECT       FileObject,
  [in, out]           PSHARE_ACCESS      ShareAccess,
  [in, out, optional] PLINK_SHARE_ACCESS LinkShareAccess
);

参数

[in] FileObject

指向文件对象的指针，该文件对象通常由当前线程关闭。

[in, out] ShareAccess

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

[in, out, optional] LinkShareAccess

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

返回值

无

备注

此例程是 IoUpdateLinkShareAccess 的倒数。

IoRemoveLinkShareAccess 不是原子操作。 因此，调用此例程的驱动程序必须通过某种锁（如互斥锁或资源锁）来保护传递给 IoRemoveLinkShareAccess 的共享文件对象，以防止共享访问计数损坏。

IoRemoveLinkShareAccess 的调用方必须在 IRQL = PASSIVE_LEVEL 以及请求关闭 FileObject 的线程上下文中运行。

要求

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

另请参阅

IoCheckLinkShareAccess

IoSetLinkShareAccess

IoUpdateLinkShareAccess