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

Статья
08/08/2023

Подпрограмма IoCheckShareAccessEx вызывается драйверами файловой системы (FSD) или другими драйверами самого высокого уровня, чтобы проверка, разрешен ли общий доступ к объекту файла.

Синтаксис

NTSTATUS IoCheckShareAccessEx(
  [in]      ACCESS_MASK   DesiredAccess,
  [in]      ULONG         DesiredShareAccess,
  [in, out] PFILE_OBJECT  FileObject,
  [in, out] PSHARE_ACCESS ShareAccess,
  [in]      BOOLEAN       Update,
  [in]      PBOOLEAN      WritePermission
);

Параметры

[in] DesiredAccess

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

[in] DesiredShareAccess

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

FILE_SHARE_READ

FILE_SHARE_WRITE

FILE_SHARE_DELETE

[in, out] FileObject

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

[in, out] ShareAccess

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

[in] Update

Указывает, следует ли обновлять состояние доступа к общей папке для FileObject. Логическое значение TRUE означает, что эта подпрограмма будет обновлять сведения о доступе к общей папке для объекта файла, если открытый запрос разрешен.

[in] WritePermission

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

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

Подпрограмма IoCheckShareAccessEx возвращает STATUS_SUCCESS, если доступ инициатора запроса к объекту файла совместим с способом его открытия в данный момент. Если запрос отклоняется из-за нарушения общего доступа, возвращается STATUS_SHARING_VIOLATION.

Требования

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

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

Процедуры диспетчера ввода-вывода

Поделиться через