Fonction IoCheckShareAccess (wdm.h)

Article
02/27/2024

La routine IoCheckShareAccess est appelée par les pilotes de système de fichiers (FSD) ou d’autres pilotes de niveau supérieur pour case activée si l’accès partagé à un objet de fichier est autorisé.

Syntaxe

NTSTATUS IoCheckShareAccess(
  [in]      ACCESS_MASK   DesiredAccess,
  [in]      ULONG         DesiredShareAccess,
  [in, out] PFILE_OBJECT  FileObject,
  [in, out] PSHARE_ACCESS ShareAccess,
  [in]      BOOLEAN       Update
);

Paramètres

[in] DesiredAccess

Spécifie une valeur de ACCESS_MASK qui indique le type d’accès souhaité à l’objet FileObject donné pour la requête ouverte actuelle. Les pilotes calculent la valeur de ce paramètre en prenant l’accès demandé dans la demande de IRP_MJ_CREATE , puis en appliquant SeAccessCheck pour chaque descripteur de sécurité afin de déterminer l’accès réel accordé. Si l’accès accordé est plus restrictif que l’accès souhaité, il s’agit d’une erreur, et le pilote doit terminer l’IRP actuel avec un status de STATUS_ACCESS_DENIED. (Notez que SeAccessCheck efface le bit MAXIMUM_ALLOWED dans l’accès accordé ; veillez à ne pas utiliser ce bit lors de la comparaison de l’accès souhaité à l’accès accordé.) Le pilote transmet ensuite l’accès accordé comme valeur de DesiredAccess.

[in] DesiredShareAccess

Spécifie le type d’accès partagé souhaité à FileObject pour la demande ouverte actuelle. La valeur de ce paramètre est généralement identique à celle de ShareAccess passée au système de fichiers ou au pilote de niveau supérieur par le gestionnaire d’E/S lors de l’ouverture de la demande. Cette valeur peut être égale à zéro ou à n’importe quelle combinaison des éléments suivants :

FILE_SHARE_READ

FILE_SHARE_WRITE

FILE_SHARE_DELETE

[in, out] FileObject

Pointeur vers l’objet file auquel case activée accès pour la requête ouverte actuelle.

[in, out] ShareAccess

Pointeur vers la structure de données d’accès partagé commune associée à FileObject. Les pilotes doivent traiter cette structure comme opaque.

[in] Update

Spécifie s’il faut mettre à jour le status d’accès partagé pour FileObject. Une valeur booléenne TRUE signifie que cette routine met à jour les informations d’accès de partage pour l’objet fichier si la demande ouverte est autorisée.

Valeur retournée

IoCheckShareAccess retourne STATUS_SUCCESS si l’accès du demandeur à l’objet fichier est compatible avec la façon dont il est actuellement ouvert. Si la demande est refusée en raison d’une violation de partage, STATUS_SHARING_VIOLATION est retournée.

Remarques

IoCheckShareAccess vérifie une demande d’ouverture d’objet fichier pour déterminer si les types d’accès souhaités et partagés spécifiés sont compatibles avec la façon dont l’objet fichier est actuellement accessible par d’autres ouvertures.

Les systèmes de fichiers conservent l’état des fichiers par le biais de structures appelées blocs de contrôle de fichiers (FCB). Le SHARE_ACCESS est une structure décrivant la façon dont le fichier est actuellement accessible par tous les ouvres. Cet état est contenu dans le fcb dans le cadre de l’état ouvert de chaque objet fichier. Chaque objet fichier ne doit avoir qu’une seule structure d’accès de partage. D’autres pilotes de niveau supérieur peuvent appeler cette routine pour case activée l’accès demandé lorsqu’un objet fichier représentant l’objet de périphérique d’un tel pilote est ouvert.

IoCheckShareAccess n’est pas une opération atomique. Par conséquent, les pilotes appelant cette routine doivent protéger l’objet de fichier partagé passé à IoCheckShareAccess au moyen d’un type de verrou, tel qu’un mutex ou un verrou de ressource, afin d’empêcher l’altération du nombre d’accès partagé.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows 2000.
Plateforme cible	Universal
En-tête	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Règles de conformité DDI	HwStorPortProhibitedDDIs(storport), IrqlIoPassive2(wdm), PowerIrpDDis(wdm)