IoReplaceFileObjectName 函式 (ntifs.h)

IoReplaceFileObjectName 例程會取代檔案對象的名稱。

語法

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

[in] FileObject

要取代其檔名的檔案對象指標。

[in] NewFileName

檔案物件之新名稱之字串緩衝區的指標。

[in] FileNameLength

檔案物件之新名稱的長度，以位元組為單位。

否則會傳回STATUS_SUCCESS或下列其中一個NTSTATUS值：

傳回碼	Description
STATUS_INVALID_PARAMETER	提供的檔案對象沒有要取代的名稱。
STATUS_INSUFFICIENT_RESOURCES	記憶體不足，可用來配置緩衝區來完成這項作業。

驅動程式應該使用 IoReplaceFileObjectName 安全地取代檔案物件中的名稱。這可讓 I/O 管理員控制與檔案對象相關聯的緩衝區存留期。直接取代檔案物件名稱而不使用 IoReplaceFileObjectName 可能會與名稱的其他用法衝突，並盡可能避免。

此例程應該用來取代檔案物件名稱，而不是手動執行此動作，以允許核心正確管理名稱的存留期。