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

Мақала
02/07/2025

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

Синтаксис

C++

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.

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

Никакой

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 10 версии 1709
минимальный поддерживаемый сервер	Windows Server 2016
целевая платформа	Всеобщий
заголовка	wdm.h
библиотеки	Ntoskrnl.lib