Funzione IoReplaceFileObjectName (ntifs.h)

La routine IoReplaceFileObjectName sostituisce il nome di un oggetto file.

Sintassi

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

Parametri

[in] FileObject

Puntatore all'oggetto file il cui nome file viene sostituito.

[in] NewFileName

Puntatore al buffer di stringa per il nuovo nome per l'oggetto file.

[in] FileNameLength

Lunghezza, in byte, del nuovo nome per l'oggetto file.

Valore restituito

Restituisce STATUS_SUCCESS o uno dei valori NTSTATUS seguenti in caso contrario:

Commenti

I driver devono usare IoReplaceFileObjectName per sostituire in modo sicuro il nome in un oggetto file. Ciò consente al gestore di I/O di controllare la durata del buffer associato all'oggetto file. La sostituzione di un nome di oggetto file direttamente senza usare IoReplaceFileObjectName può entrare in conflitto con altri usi del nome e deve essere evitata quando possibile.

Questa routine deve essere usata per sostituire il nome dell'oggetto file anziché farlo manualmente per consentire al kernel di gestire correttamente la durata del nome.

Requisiti