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