IoSetFileOrigin 函数 (ntddk.h)
IoSetFileOrigin 例程指定给定文件对象是否用于远程创建请求。
语法
NTSTATUS IoSetFileOrigin(
[in] PFILE_OBJECT FileObject,
[in] BOOLEAN Remote
);
参数
[in] FileObject
指向文件对象的指针。
[in] Remote
设置为 TRUE 可对文件对象设置FO_REMOTE_ORIGIN标志; 设置为 FALSE 可将其清除。
返回值
如果尚未根据 Remote 参数指定的 (或清除文件对象上的) FO_REMOTE_ORIGIN标志， 则 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) |
| Library | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | 任何级别 |