Fonction IoCheckShareAccess (wdm.h)

La routine IoCheckShareAccess est appelée par les pilotes de système de fichiers (FSD) ou d’autres pilotes de niveau supérieur pour vérifier 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 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 requête IRP_MJ_CREATE , puis en appliquant SeAccessCheck pour chaque descripteur de sécurité pour 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 état 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 souhaité d’accès partagé à FileObject pour la requête ouverte actuelle. La valeur de ce paramètre est généralement identique au pilote ShareAccess passé au système de fichiers ou au pilote de niveau supérieur par le gestionnaire d’E/S lorsque la requête ouverte a été effectuée. Cette valeur peut être zéro ou toute combinaison des éléments suivants :

FILE_SHARE_READ

FILE_SHARE_WRITE

FILE_SHARE_DELETE

[in, out] FileObject

Pointeur vers l’objet de fichier pour lequel vérifier l’accès à 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 l’état d’accès au partage pour FileObject. Une valeur booléenne true signifie que cette routine met à jour les informations d’accès de partage pour l’objet de fichier si la requête ouverte est autorisée.

Valeur de retour

IoCheckShareAccess retourne STATUS_SUCCESS si l’accès du demandeur à l’objet de 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 de 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 de 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 (FCBs). La SHARE_ACCESS est une structure décrivant comment le fichier est actuellement accessible par tous s’ouvre. Cet état est contenu dans le FCB dans le cadre de l’état ouvert pour chaque objet de fichier. Chaque objet de fichier ne doit avoir qu’une seule structure d’accès au partage. D’autres pilotes de niveau supérieur peuvent appeler cette routine pour vérifier l’accès demandé lorsqu’un objet de fichier représentant l’objet d’appareil 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é transmis à IoCheckShareAccess par le biais d’un type de verrou, tel qu’un mutex ou un verrou de ressource, afin d’empêcher la corruption des nombres d’accès partagés.

Configuration requise

   
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 HwStorPortProhibitedDIs(storport), IrqlIoPassive2(wdm), PowerIrpDDis(wdm)

Voir aussi

ACCESS_MASK

IoCreateFile

IoCreateFileEx

IoGetRelatedDeviceObject

IoRemoveShareAccess

IoSetShareAccess

IoUpdateShareAccess