Función IoReplaceFileObjectName (ntifs.h)

La rutina IoReplaceFileObjectName reemplaza el nombre de un objeto de archivo.

Sintaxis

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

Parámetros

[in] FileObject

Puntero al objeto de archivo cuyo nombre de archivo se va a reemplazar.

[in] NewFileName

Puntero al búfer de cadena para el nuevo nombre del objeto de archivo.

[in] FileNameLength

Longitud, en bytes, del nuevo nombre del objeto de archivo.

Valor devuelto

Devuelve STATUS_SUCCESS o uno de los siguientes valores NTSTATUS de lo contrario:

Código devuelto	Descripción
STATUS_INVALID_PARAMETER	El objeto de archivo proporcionado no tiene un nombre para reemplazar.
STATUS_INSUFFICIENT_RESOURCES	La memoria inadecuada está disponible para asignar un búfer para completar esta operación.

Comentarios

Los controladores deben usar IoReplaceFileObjectName para reemplazar de forma segura el nombre en un objeto de archivo. Esto permite al administrador de E/S controlar la duración del búfer asociado al objeto de archivo. Reemplazar un nombre de objeto de archivo directamente sin usar IoReplaceFileObjectName puede entrar en conflicto con otros usos del nombre y debe evitarse cuando sea posible.

Esta rutina se debe usar para reemplazar el nombre del objeto de archivo en lugar de hacerlo manualmente para permitir que el kernel administre correctamente la duración del nombre.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7
Plataforma de destino	Universal
Encabezado	ntifs.h (incluya Ntifs.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL