Функция 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

Указатель на общую структуру данных общего доступа (LINK_SHARE_ACCESS), связанную с FileObject. Драйверы должны рассматривать эту структуру как непрозрачную.

[in] IoShareAccessFlags

Битовая маска следующих флагов:

IO_SHARE_ACCESS_NO_WRITE_PERMISSION (0x80000000) указывает, что у пользователя нет разрешения на запись файла. Этот флаг используется для предотвращения открытия файла для монопольного доступа на чтение, если у пользователя нет соответствующих разрешений.

IO_CHECK_SHARE_ACCESS_UPDATE_SHARE_ACCESS (0x00000001) указывает, обновляется ли структура SHARE_ACCESS.

Возвращаемое значение

None

Требования

Требование Значение
Минимальная версия клиента Windows 10 версии 1709
Минимальная версия сервера Windows Server 2016
Целевая платформа Универсальное
Верхняя часть wdm.h
Библиотека Ntoskrnl.lib

См. также раздел

IoCheckLinkShareAccess

IoRemoveLinkShareAccess

IoUpdateLinkShareAccess