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标志尚未设置(或清除)由 Remote 参数指定,IoSetFileOrigin 设置或清除标志,并返回STATUS_SUCCESS。

如果已按指定设置(或清除)标志,IoSetFileOrigin 返回STATUS_INVALID_PARAMETER_MIX,并且未设置或清除标志。

言论

网络文件系统调用 IoSetFileOrigin 来设置或清除由 fileObject 指向的文件对象上的FO_REMOTE_ORIGIN标志。 此标志设置为指示已创建文件对象以满足远程创建请求。

网络文件系统应在其服务器中调用 IoSetFileOrigin,以获取创建的任何文件对象以满足网络客户端的创建请求。

文件系统筛选器驱动程序不应调用 IoSetFileOrigin

要求

要求 价值
最低支持的客户端 此例程在 Microsoft Windows XP 及更高版本上可用。
目标平台 普遍
标头 ntddk.h (包括 Ntddk.h、Ntifs.h、Fltkernel.h)
NtosKrnl.lib
DLL NtosKrnl.exe
IRQL 任何级别

另请参阅

IoIsFileOriginRemote