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

  • Статья

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

Синтаксис

void IoUpdateShareAccess(
  [in]      PFILE_OBJECT  FileObject,
  [in, out] PSHARE_ACCESS ShareAccess
);

Параметры

[in] FileObject

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

[in, out] ShareAccess

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

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

None

Remarks

IoUpdateShareAccess не является атомарной операцией. Таким образом, драйверы, вызывающие эту подпрограмму, должны защищать объект общего файла, передаваемый в IoUpdateShareAccess , с помощью какой-либо блокировки, например блокировки мьютекса или ресурса, чтобы предотвратить повреждение общего числа доступа.

Перед вызовом IoUpdateShareAccess вызывающий объект должен успешно вызвать IoCheckShareAccess с параметром Update , равным False. Такой вызов IoCheckShareAccess определяет, совместим ли запрошенный общий доступ с способом доступа к объекту файла с помощью других открытий, но не обновляет структуру SHARE_ACCESS . IoUpdateShareAccess фактически обновляет структуру SHARE_ACCESS , связанную с объектом файла.

Требования

Требование Значение
Минимальная версия клиента Доступно начиная с Windows 2000.
Целевая платформа Универсальное
Верхняя часть wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)
Библиотека NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Правила соответствия DDI HwStorPortProhibitedDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm)

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

IoCheckShareAccess

IoRemoveShareAccess

IoSetShareAccess