Routine MRxQuerySdInfo

Article
02/12/2024

La routineMRxQuerySdInfo est appelée par RDBSS pour demander qu’un mini-redirecteur réseau interroge les informations de descripteur de sécurité sur un objet de système de fichiers.

Syntaxe

PMRX_CALLDOWN MRxQuerySdInfo;

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

Paramètres

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

Valeur retournée

MRxQuerySdInfo 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_BUFFER_OVERFLOW	La mémoire tampon pour recevoir les informations de descripteur de sécurité était trop petite. Cette valeur de retour doit être considérée comme réussie et le plus grand nombre de données valides possible doivent être retournées dans le membre Info.Buffer de la structure RX_CONTEXT pointée par le paramètre RxContext .
STATUS_BUFFER_TOO_SMALL	La mémoire tampon est trop petite pour recevoir les données demandées. Si cette valeur est retournée, le membre InformationToReturn de la structure RX_CONTEXT pointée par le paramètre RxContext doit être défini sur la taille minimale de la mémoire tampon attendue pour que l’appel réussisse.
STATUS_CONNECTION_DISCONNECTED	La connexion a été déconnecté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é.
STATUS_NOT_IMPLEMENTED	Une fonctionnalité demandée, telle que les informations d’un fichier de page distante, n’est pas implémentée.
STATUS_NOT_SUPPORTED	Les informations de descripteur de sécurité ne sont pas prises en charge sur le partage distant.
STATUS_OBJECT_PATH_NOT_FOUND	Le chemin d’accès de l’objet est introuvable. Cette erreur peut être retournée si des informations sur un objet de flux NTFS ont été demandées et que le système de fichiers distant ne prend pas en charge les flux.
STATUS_REPARSE	Une analyse est nécessaire pour gérer un lien symbolique.

Remarques

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

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

Le membre QuerySecurity.SecurityInformation est défini sur IrpSp-Parameters.QuerySecurity.SecurityInformation>.

Le membre Info.Buffer est défini sur la mémoire tampon de l’utilisateur à partir du paquet de requête 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.QuerySecurity.Length>.

En cas de réussite, le mini-redirecteur réseau doit définir le membre InformationToReturn de la structure RX_CONTEXT sur la longueur des informations de sécurité retournées. Si l’appel à MRxQuerySdInfo a réussi, RDBSS définit le membre IoStatus.Information de l’IRP sur le membre InformationToReturn de RX_CONTEXT.