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 di FO_REMOTE_ORIGIN sull'oggetto file, false per cancellarlo.
Valore restituito
Se il flag di 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.
Osservazioni
I file system di rete chiamano IoSetFileOrigin per impostare o cancellare il flag di 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.
Fabbisogno
| 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 |