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 |
| 目標平台 | Universal |
| 標頭 | wdm.h |
| 程式庫 | NtosKrnl.lib |
| Dll | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |