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

Voir aussi

IoIsFileOriginRemote