IoSetFileOrigin, fonction (ntddk.h)
La routine IoSetFileOrigin spécifie si un objet de fichier donné est destiné à une demande de création distante.
Syntaxe
NTSTATUS IoSetFileOrigin(
[in] PFILE_OBJECT FileObject,
[in] BOOLEAN Remote
);
Paramètres
[in] FileObject
Pointeur vers l’objet fichier.
[in] Remote
Défini sur TRUE pour définir l’indicateur de FO_REMOTE_ORIGIN sur l’objet de fichier, FALSE pour l’effacer.
Valeur de retour
Si l’indicateur FO_REMOTE_ORIGIN sur l’objet de fichier n’est pas déjà défini (ou effacé) tel que spécifié par le paramètre Remote, IoSetFileOrigin définit ou efface l’indicateur le cas échéant et retourne STATUS_SUCCESS.
Si l’indicateur est déjà défini (ou effacé) tel qu’il est spécifié, IoSetFileOrigin retourne STATUS_INVALID_PARAMETER_MIX et ne définit pas ou efface l’indicateur.
Remarques
Les systèmes de fichiers réseau appellent IoSetFileOrigin pour définir ou effacer l’indicateur de FO_REMOTE_ORIGIN sur l’objet de fichier pointé par FileObject. Cet indicateur est défini pour indiquer que l’objet de fichier a été créé pour satisfaire une demande de création distante.
Les systèmes de fichiers réseau doivent appeler IoSetFileOrigin dans leurs serveurs pour tous les objets de fichiers créés pour satisfaire une demande de création à partir d’un client réseau.
Les pilotes de filtre de système de fichiers ne doivent pas appeler IoSetFileOrigin.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Cette routine est disponible sur Microsoft Windows XP et versions ultérieures. |
| plateforme cible | Universel |
| d’en-tête | ntddk.h (include Ntddk.h, Ntifs.h, Fltkernel.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | N’importe quel niveau |