Fungsi IoSetFileOrigin (ntddk.h)
Rutinitas IoSetFileOrigin menentukan apakah objek file tertentu adalah untuk permintaan pembuatan jarak jauh.
Sintaks
NTSTATUS IoSetFileOrigin(
[in] PFILE_OBJECT FileObject,
[in] BOOLEAN Remote
);
Parameter
[in] FileObject
Penunjuk ke objek file.
[in] Remote
Atur ke TRUE untuk mengatur bendera FO_REMOTE_ORIGIN pada objek file, FALSE untuk menghapusnya.
Nilai kembali
Jika bendera FO_REMOTE_ORIGIN pada objek file belum diatur (atau dibersihkan) seperti yang ditentukan oleh parameter Jarak Jauh , IoSetFileOrigin mengatur atau menghapus bendera yang sesuai dan mengembalikan STATUS_SUCCESS.
Jika bendera sudah diatur (atau dibersihkan) seperti yang ditentukan, IoSetFileOrigin mengembalikan STATUS_INVALID_PARAMETER_MIX dan tidak mengatur atau menghapus bendera.
Keterangan
Sistem file jaringan memanggil IoSetFileOrigin untuk mengatur atau menghapus bendera FO_REMOTE_ORIGIN pada objek file yang ditunjukkan oleh FileObject. Bendera ini diatur untuk menunjukkan bahwa objek file dibuat untuk memenuhi permintaan pembuatan jarak jauh.
Sistem file jaringan harus memanggil IoSetFileOrigin di server mereka untuk objek file apa pun yang dibuat untuk memenuhi permintaan buat dari klien jaringan.
Driver filter sistem file tidak boleh memanggil IoSetFileOrigin.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Rutinitas ini tersedia di Microsoft Windows XP dan yang lebih baru. |
| Target Platform | Universal |
| Header | ntddk.h (termasuk Ntddk.h, Ntifs.h, Fltkernel.h) |
| Pustaka | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | Tingkat apa pun |