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:

Codice restituito	Descrizione
STATUS_INVALID_PARAMETER	L'oggetto file specificato non ha un nome da sostituire.
STATUS_INSUFFICIENT_RESOURCES	Memoria inadeguata è disponibile per allocare un buffer per completare questa operazione.

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

Requisito	Valore
Client minimo supportato	Windows 7
Piattaforma di destinazione	Universale
Intestazione	ntifs.h (include Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL