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

另請參閱

IoCheckLinkShareAccess

IoRemoveLinkShareAccess

IoUpdateLinkShareAccess