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 ，以在 FileObject所指向的檔案物件上設定或清除FO_REMOTE_ORIGIN旗標。 此旗標設定為表示已建立檔案對象以滿足遠端建立要求。
網路文件系統應該在其伺服器中呼叫 IoSetFileOrigin ，以取得任何建立的檔案物件，以滿足來自網路用戶端的建立要求。
文件系統篩選驅動程式不應該呼叫 IoSetFileOrigin。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 此例程可在 Microsoft Windows XP 和更新版本上使用。 |
| 目標平台 | Universal |
| 標頭 | ntddk.h (包含 Ntddk.h、Ntifs.h、Fltkernel.h) |
| 程式庫 | NtosKrnl.lib |
| Dll | NtosKrnl.exe |
| IRQL | 任何層級 |