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 的共用檔案物件，例如 mutex或資源鎖定，以防止共用存取計數損毀。

IoRemoveLinkShareAccess 的呼叫端必須在 IRQL = PASSIVE_LEVEL，並在要求關閉 FileObject 的線程內容中執行。

規格需求

需求 值
最低支援的用戶端 Windows 10 (版本 1709)
最低支援的伺服器 Windows Server 2016
目標平台 Universal
標頭 wdm.h
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL PASSIVE_LEVEL

另請參閱

IoCheckLinkShareAccess

IoSetLinkShareAccess

IoUpdateLinkShareAccess