IoSetLinkShareAccess 函式 (wdm.h)
IoSetLinkShareAccess 例程會設定共用指定檔案物件之連結的訪問許可權。
語法
void IoSetLinkShareAccess(
[in] ACCESS_MASK DesiredAccess,
[in] ULONG DesiredShareAccess,
[in, out] PFILE_OBJECT FileObject,
[in, out] PSHARE_ACCESS ShareAccess,
[in, out, optional] PLINK_SHARE_ACCESS LinkShareAccess,
[in] ULONG IoShareAccessFlags
);
參數
[in] DesiredAccess
指定 ACCESS_MASK 值，這個值表示指定檔案物件之存取所需的類型。
[in] DesiredShareAccess
指定目前開啟要求之檔案對象的共用存取所需的類型。 此參數的值通常與在提出開啟要求時傳遞至文件系統或最高層級驅動程式的 ShareAccess 參數相同。 此值可以是零，或下列任何組合：
FILE_SHARE_READ
FILE_SHARE_WRITE
FILE_SHARE_DELETE
[in, out] FileObject
要檢查目前開啟要求的存取權之檔案物件的指標。
[in, out] ShareAccess
與 FileObject 相關聯的通用共用存取數據結構的指標。 驅動程式應將此結構視為不透明。
[in, out, optional] LinkShareAccess
與 FileObject 相關聯的通用連結共用存取數據結構指標 (LINK_SHARE_ACCESS) 。 驅動程式應將此結構視為不透明。
[in] IoShareAccessFlags
這些旗標的位掩碼：
IO_SHARE_ACCESS_NO_WRITE_PERMISSION (0x80000000) 指定用户没有档案的写入权限。 當使用者沒有適當的許可權時，此旗標可用來防止開啟檔案以進行獨佔讀取許可權。
IO_CHECK_SHARE_ACCESS_UPDATE_SHARE_ACCESS (0x00000001) 指出是否已更新SHARE_ACCESS結構。
傳回值
無
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 10 (版本 1709) |
| 最低支援的伺服器 | Windows Server 2016 |
| 目標平台 | Universal |
| 標頭 | wdm.h |
| 程式庫 | Ntoskrnl.lib |