Функция IoUpdateLinkShareAccess (wdm.h)
Подпрограмма IoUpdateLinkShareAccess обновляет доступ к общей папке для заданного объекта файла, как правило, при открытии файла.
Синтаксис
void IoUpdateLinkShareAccess(
[in] PFILE_OBJECT FileObject,
[in, out] PSHARE_ACCESS ShareAccess,
[in, out, optional] PLINK_SHARE_ACCESS LinkShareAccess
);
Параметры
[in] FileObject
Указатель на объект файла, который обычно закрывается текущим потоком.
[in, out] ShareAccess
Указатель на общую структуру данных с общим доступом, связанную с FileObject. Драйверы должны рассматривать эту структуру как непрозрачную.
[in, out, optional] LinkShareAccess
Указатель на общую структуру данных общего доступа (LINK_SHARE_ACCESS), связанную с FileObject. Драйверы должны рассматривать эту структуру как непрозрачную.
Возвращаемое значение
None
Remarks
IoUpdateLinkShareAccess не является атомарной операцией. Таким образом, драйверы, вызывающие эту подпрограмму, должны защищать объект общего файла, передаваемый в IoUpdateLinkShareAccess , с помощью какой-либо блокировки, например блокировки мьютекса или ресурса, чтобы предотвратить повреждение счетчиков общего доступа.
Перед вызовом IoUpdateLinkShareAccess вызывающий объект должен успешно вызвать IoCheckLinkShareAccess с параметром Update , равным False. Такой вызов IoCheckLinkShareAccess определяет, совместим ли запрошенный общий доступ с способом доступа к объекту файла при других открытиях, но не обновляет структуру SHARE_ACCESS . IoUpdateLinkShareAccess фактически обновляет структуру SHARE_ACCESS , связанную с объектом файла.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 10 версии 1709 |
| Минимальная версия сервера | Windows Server 2016 |
| Целевая платформа | Универсальное |
| Верхняя часть | wdm.h |
| Библиотека | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |