ioRemoveShareAccess 函式 (wdm.h)
IoRemoveShareAccess 例程會移除檔案物件指定開啟實例的存取和共用存取資訊。
語法
void IoRemoveShareAccess(
[in] PFILE_OBJECT FileObject,
[in, out] PSHARE_ACCESS ShareAccess
);
參數
[in] FileObject
檔案物件的指標,通常是由目前線程所關閉。
[in, out] ShareAccess
共用存取結構的指標,描述目前如何存取開啟的檔案物件。
傳回值
無
備註
此例程是 IoUpdateShareAccess的倒數。
IoRemoveShareAccess 不是不可部分完成的作業。 因此,呼叫此例程的驅動程式必須透過某種類型的鎖定來保護傳遞至 IoRemoveShareAccess 的共用檔案物件,例如 mutex 或資源鎖定,以避免共用存取計數損毀。
IoRemoveShareAccess 的呼叫端必須在 IRQL = PASSIVE_LEVEL 執行,並在要求關閉 FileObject 的線程內容中執行。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 從 Windows 2000 開始提供。 |
目標平台 | Universal |
標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
程式庫 | NtosKrnl.lib |
Dll | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL (请参阅一节) |
DDI 合規性規則 | HwStorPortProhibitedDDIs (storport) 、 IrqlIoPassive5 (wdm) 、 PowerIrpDDis (wdm) |