Routine MRxSetEaInfo

Article
02/02/2024

La routineMRxSetEaInfo est appelée par RDBSS pour demander à un mini-redirecteur réseau de définir des informations d’attribut étendues sur un objet de système de fichiers.

Syntaxe

PMRX_CALLDOWN MRxSetEaInfo;

NTSTATUS MRxSetEaInfo(
  _Inout_ PRX_CONTEXT RxContext
)
{ ... }

Paramètres

RxContext [in, out]
Pointeur vers la structure RX_CONTEXT. Ce paramètre contient l’ipr qui demande l’opération.

Valeur retournée

MRxSetEaInfo retourne STATUS_SUCCESS sur la réussite ou une valeur NTSTATUS appropriée, telle que l’une des suivantes :

Code de retour	Description
STATUS_ACCESS_DENIED	L’appelant ne dispose pas de la sécurité appropriée pour cette opération.
STATUS_EA_TOO_LARGE	Les informations d’attribut étendu qui sont passées sont supérieures à la taille prise en charge par le partage distant.
STATUS_FILE_CLOSED	La structure SRV_OPEN a été fermée.
STATUS_INSUFFICIENT_RESOURCES	Les ressources étaient insuffisantes pour terminer la requête.
STATUS_INVALID_PARAMETER	Un paramètre non valide a été spécifié.
STATUS_NETWORK_ACCESS_DENIED	L’accès réseau a été refusé. Cette erreur peut être retournée si le mini-redirecteur réseau a été invité à définir des attributs étendus sur un partage en lecture seule.
STATUS_NOT_IMPLEMENTED	Une fonctionnalité demandée, telle que la définition d’informations étendues sur un fichier de page distante, n’est pas implémentée.
STATUS_NOT_SUPPORTED	Les attributs étendus ne sont pas pris en charge.
STATUS_OBJECT_NAME_NOT_FOUND	Le nom de l’objet est introuvable. Cette erreur peut être retournée si le mini-redirecteur réseau a été invité à définir des attributs étendus sur un fichier, mais que le fichier n’existe pas.
STATUS_OBJECT_PATH_NOT_FOUND	Le chemin d’accès de l’objet est introuvable. Cette erreur peut être retournée si un objet de flux NTFS a été passé et que le système de fichiers distant ne prend pas en charge les flux.
STATUS_ONLY_IF_CONNECTED	La structure SRV_OPEN n’est pas connectée.
STATUS_REPARSE	Une analyse est nécessaire pour gérer un lien symbolique.

Remarques

RDBSS émet un appel à MRxSetEaInfo en réponse à la réception d’une demande de IRP_MJ_SET_EA .

Avant d’appeler MRxSetEaInfo, RDBSS modifie les membres suivants dans la structure RX_CONTEXT pointée par le paramètre RxContext :

Le membre Info.Buffer est défini sur la mémoire tampon de l’utilisateur à partir du paquet de demande d’E/S. Cette mémoire tampon a déjà été verrouillée par RDBSS si nécessaire.

Le membre Info.LengthRemaining est défini sur IrpSp-Parameters.QueryEa.Length>.