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

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

IoCheckLinkShareAccess

IoRemoveLinkShareAccess

IoSetLinkShareAccess