Fonction IoSetFileOrigin (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éfinissez sur TRUE pour définir l’indicateur FO_REMOTE_ORIGIN sur l’objet fichier, false pour l’effacer.

Valeur retournée

Si l’indicateur FO_REMOTE_ORIGIN sur l’objet fichier n’est pas déjà défini (ou effacé) comme spécifié par le paramètre Remote , IoSetFileOrigin définit ou efface l’indicateur comme il convient et retourne STATUS_SUCCESS.

Si l’indicateur est déjà défini (ou effacé) comme 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 FO_REMOTE_ORIGIN sur l’objet de fichier pointé par FileObject. Cet indicateur est défini pour indiquer que l’objet file a été créé pour répondre à 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 répondre à 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.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Cette routine est disponible sur Microsoft Windows XP et versions ultérieures.
Plateforme cible	Universal
En-tête	ntddk.h (inclure Ntddk.h, Ntifs.h, Fltkernel.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	N’importe quel niveau

Voir aussi

IoIsFileOriginRemote