Функция IoSetShareAccessEx (wdm.h)

Статья
08/08/2023

Подпрограмма IoSetShareAccessEx задает права доступа для совместного использования указанного объекта файла.

Синтаксис

void IoSetShareAccessEx(
  [in]           ACCESS_MASK   DesiredAccess,
  [in]           ULONG         DesiredShareAccess,
  [in, out]      PFILE_OBJECT  FileObject,
  [out]          PSHARE_ACCESS ShareAccess,
  [in, optional] PBOOLEAN      WritePermission
);

Параметры

[in] DesiredAccess

Задает значение ACCESS_MASK , представляющее тип доступа, запрашиваемый для объекта файла. Полный список системных флагов DesiredAccess см. в разделе IoCreateFile.

[in] DesiredShareAccess

Указывает тип доступа к общей папке, задающийся для объекта файла. Это значение может быть равно нулю или любой комбинации следующих флагов:

FILE_SHARE_READ

FILE_SHARE_WRITE

FILE_SHARE_DELETE

[in, out] FileObject

Указатель на объект файла, для которого устанавливается или сбрасывается доступ к общей папке.

[out] ShareAccess

Указатель на структуру SHARE_ACCESS , связанную с FileObject. Драйверы должны рассматривать эту структуру как непрозрачную.

[in, optional] WritePermission

Указатель на значение , указывающее, имеет ли файловый объект разрешение на запись. Это значение равно TRUE , если общая папка имеет разрешение на запись; в противном случае — FALSE. Если значение равно FALSE и вызывающий объект пытается получить монопольный доступ на чтение, разрешение на запись понижается до FILE_SHARE_READ.

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

None

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows 7 и более поздних версиях Windows.
Целевая платформа	Универсальное
Верхняя часть	wdm.h
Библиотека	Ntoskrnl.lib

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

ACCESS_MASK

IoCreateFile