Функция IoSetFileOrigin (ntddk.h)

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

Синтаксис

NTSTATUS IoSetFileOrigin(
  [in] PFILE_OBJECT FileObject,
  [in] BOOLEAN      Remote
);

Параметры

[in] FileObject

Указатель на объект file.

[in] Remote

Задайте значение TRUE , чтобы задать флаг FO_REMOTE_ORIGIN в объекте файла, и FALSE , чтобы очистить его.

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

Если флаг FO_REMOTE_ORIGIN для объекта файла еще не задан (или не снят), как указано в параметре Remote , IoSetFileOrigin устанавливает или очищает флаг соответствующим образом и возвращает STATUS_SUCCESS.

Если флаг уже установлен (или снят), как указано, IoSetFileOrigin возвращает STATUS_INVALID_PARAMETER_MIX и не устанавливает или не очищает флаг.

Комментарии

Сетевые файловые системы вызывают IoSetFileOrigin , чтобы установить или снять флаг FO_REMOTE_ORIGIN для объекта файла, на который указывает FileObject. Этот флаг указывает, что объект файла был создан для удовлетворения удаленного запроса на создание.

Сетевые файловые системы должны вызывать IoSetFileOrigin на своих серверах для любых объектов файлов, созданных для удовлетворения запроса на создание от сетевого клиента.

Драйверы фильтров файловой системы не должны вызывать IoSetFileOrigin.

Требования

Требование Значение
Минимальная версия клиента Эта процедура доступна в Microsoft Windows XP и более поздних версиях.
Целевая платформа Универсальное
Верхняя часть ntddk.h (включая Ntddk.h, Ntifs.h, Fltkernel.h)
Библиотека NtosKrnl.lib
DLL NtosKrnl.exe
IRQL Любой уровень

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

IoIsFileOriginRemote