Fungsi IoReplaceFileObjectName (ntifs.h)

  • Artikel

Rutinitas IoReplaceFileObjectName menggantikan nama objek file.

Sintaks

NTSTATUS IoReplaceFileObjectName(
  [in] PFILE_OBJECT FileObject,
  [in] PWSTR        NewFileName,
  [in] USHORT       FileNameLength
);

Parameter

[in] FileObject

Penunjuk ke objek file yang nama filenya sedang diganti.

[in] NewFileName

Penunjuk ke buffer string untuk nama baru untuk objek file.

[in] FileNameLength

Panjang, dalam byte, dari nama baru untuk objek file.

Nilai kembali

Mengembalikan STATUS_SUCCESS atau salah satu nilai NTSTATUS berikut jika tidak:

Menampilkan kode Deskripsi
STATUS_INVALID_PARAMETER Objek file yang disediakan tidak memiliki nama untuk diganti.
STATUS_INSUFFICIENT_RESOURCES Memori yang tidak memadai tersedia untuk mengalokasikan buffer untuk menyelesaikan operasi ini.

Keterangan

Driver harus menggunakan IoReplaceFileObjectName untuk mengganti nama dalam objek file dengan aman. Ini memungkinkan manajer I/O untuk mengontrol masa pakai buffer yang terkait dengan objek file. Mengganti nama objek file secara langsung tanpa menggunakan IoReplaceFileObjectName dapat bertentangan dengan penggunaan nama lain dan harus dihindari jika memungkinkan.

Rutinitas ini harus digunakan untuk mengganti nama objek file alih-alih melakukannya secara manual untuk memungkinkan kernel mengelola masa pakai nama dengan benar.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 7
Target Platform Universal
Header ntifs.h (termasuk Ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL