IoReplaceFileObjectName-Funktion (ntifs.h)

Die IoReplaceFileObjectName-Routine ersetzt den Namen eines Dateiobjekts.

Syntax

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

Parameter

[in] FileObject

Zeiger auf das Dateiobjekt, dessen Dateiname ersetzt wird.

[in] NewFileName

Zeiger auf den Zeichenfolgenpuffer für den neuen Namen für das Dateiobjekt.

[in] FileNameLength

Länge des neuen Namens für das Dateiobjekt in Byte.

Rückgabewert

Gibt andernfalls STATUS_SUCCESS oder einen der folgenden NTSTATUS-Werte zurück:

Hinweise

Treiber sollten IoReplaceFileObjectName verwenden, um den Namen in einem Dateiobjekt sicher zu ersetzen. Dadurch kann der E/A-Manager die Lebensdauer des Puffers steuern, der dem Dateiobjekt zugeordnet ist. Das direkte Ersetzen eines Dateiobjektnamens ohne Verwendung von IoReplaceFileObjectName kann mit anderen Verwendungen des Namens in Konflikt stehen und sollte nach Möglichkeit vermieden werden.

Diese Routine sollte verwendet werden, um den Namen des Dateiobjekts zu ersetzen, anstatt dies manuell zu tun, damit der Kernel die Lebensdauer des Namens ordnungsgemäß verwalten kann.

Anforderungen