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 參數相同,參數會在提出開啟要求時由 I/O 管理員傳遞至文件系統或最高層級驅動程式。 此值可以是零,或下列任何組合:
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 |
目標平臺 | 普遍 |
標頭 | wdm.h |
連結庫 | Ntoskrnl.lib |