Funzione IoSetFileOrigin (ntddk.h)

La routine IoSetFileOrigin specifica se un determinato oggetto file è per una richiesta di creazione remota.

Sintassi

NTSTATUS IoSetFileOrigin(
  [in] PFILE_OBJECT FileObject,
  [in] BOOLEAN      Remote
);

Parametri

[in] FileObject

Puntatore all'oggetto file.

[in] Remote

Impostare su TRUE per impostare il flag FO_REMOTE_ORIGIN sull'oggetto file, FALSE per cancellarlo.

Valore restituito

Se il flag FO_REMOTE_ORIGIN nell'oggetto file non è già impostato (o cancellato) come specificato dal parametro Remote , IoSetFileOrigin imposta o cancella il flag in base alle esigenze e restituisce STATUS_SUCCESS.

Se il flag è già impostato (o cancellato) come specificato, IoSetFileOrigin restituisce STATUS_INVALID_PARAMETER_MIX e non imposta o cancella il flag.

Commenti

I file system di rete chiamano IoSetFileOrigin per impostare o cancellare il flag FO_REMOTE_ORIGIN sull'oggetto file a cui punta FileObject. Questo flag è impostato per indicare che l'oggetto file è stato creato per soddisfare una richiesta di creazione remota.

I file system di rete devono chiamare IoSetFileOrigin nei server per tutti gli oggetti file creati per soddisfare una richiesta di creazione da un client di rete.

I driver di filtro del file system non devono chiamare IoSetFileOrigin.

Requisiti

Requisito Valore
Client minimo supportato Questa routine è disponibile in Microsoft Windows XP e versioni successive.
Piattaforma di destinazione Universale
Intestazione ntddk.h (include Ntddk.h, Ntifs.h, Fltkernel.h)
Libreria NtosKrnl.lib
DLL NtosKrnl.exe
IRQL Qualsiasi livello

Vedi anche

IoIsFileOriginRemote