IoRemoveShareAccess 函式 (wdm.h)
IoRemoveShareAccess 例程會移除檔案物件的指定開啟實例的存取和共用存取資訊。
語法
void IoRemoveShareAccess(
[in] PFILE_OBJECT FileObject,
[in, out] PSHARE_ACCESS ShareAccess
);
參數
[in] FileObject
檔案物件的指標,通常由目前線程關閉。
[in, out] ShareAccess
共用存取結構的指標,描述目前如何存取開啟的檔案物件。
傳回值
沒有
言論
此例程是 IoUpdateShareAccess的對等。
IoRemoveShareAccess 不是不可部分完成的作業。 因此,呼叫此例程的驅動程式必須透過某種鎖定,例如 Mutex 或資源鎖定,保護傳遞至 ioRemoveShareAccess 的共用檔案物件,以防止共用存取計數損毀。
IoRemoveShareAccess 的呼叫者必須在 IRQL = PASSIVE_LEVEL,並在要求關閉 FileObject 的線程內容中執行。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 從 Windows 2000 開始提供。 |
目標平臺 | 普遍 |
標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
連結庫 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL (請參閱一節) |
DDI 合規性規則 | HwStorPortProhibitedDIs(storport)、IrqlIoPassive5(wdm)、PowerIrpDDis(wdm) |