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 | 任何级别 |