IoUpdateLinkShareAccess 函式 (wdm.h)
IoUpdateLinkShareAccess 例程會更新指定檔案對象的共用存取權,通常是開啟檔案時。
語法
void IoUpdateLinkShareAccess(
[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 不是不可部分完成的作業。 因此,呼叫此例程的驅動程式必須保護傳遞至 ioUpdateLinkShareAccess 的共用檔案物件,方法是透過某種鎖定,例如 mutex 或資源鎖定,以防止共用存取計數損毀。
呼叫 IoUpdateLinkShareAccess之前,呼叫端必須成功呼叫 ioCheckLinkShareAccess,且 Update 設為 False。 這類呼叫 IoCheckLinkShareAccess 會判斷要求的共用存取是否與檔案物件目前由其他開啟存取的方式相容,但不會更新 SHARE_ACCESS 結構。 IoUpdateLinkShareAccess 實際上會更新與檔案對象相關聯的 SHARE_ACCESS 結構。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 10 版本 1709 |
支援的最低伺服器 | Windows Server 2016 |
目標平臺 | 普遍 |
標頭 | wdm.h |
連結庫 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |