Fungsi IoSetFileOrigin (ntddk.h)

  • Artikel

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

Lihat juga

IoIsFileOriginRemote