Fungsi IoReplaceFileObjectName (ntifs.h)

Artikel
02/26/2024

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

Bagikan melalui