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

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

Синтаксис

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

Параметры

[in] FileObject

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

[in] Remote

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

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

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

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

Замечания

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

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

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

Требования

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

См. также

IoIsFileOriginRemote