Fonction IoCheckShareAccessEx (wdm.h)
La routine IoCheckShareAccessEx 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 IoCheckShareAccessEx(
[in] ACCESS_MASK DesiredAccess,
[in] ULONG DesiredShareAccess,
[in, out] PFILE_OBJECT FileObject,
[in, out] PSHARE_ACCESS ShareAccess,
[in] BOOLEAN Update,
[in] PBOOLEAN WritePermission
);
Paramètres
[in] DesiredAccess
Spécifie une valeur ACCESS_MASK qui indique le type d’accès souhaité à l’objet de fichier donné.
[in] DesiredShareAccess
Spécifie le type souhaité d’accès partagé à l’objet de fichier pour la requête ouverte actuelle. La valeur de ce paramètre est généralement identique au paramètre 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 n’importe quelle 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 au partage 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 de TRUE signifie que cette routine met à jour les informations d’accès de partage pour l’objet de fichier si la demande ouverte est autorisée.
[in] WritePermission
Spécifie si l’accès au partage dispose d’une autorisation d’écriture. Cette valeur est TRUE si le partage dispose d’une autorisation d’écriture ; sinon, FALSE. Si la valeur est FALSE et que l’accès au partage dispose d’une autorisation d’écriture et que l’appelant tente de prendre un accès en lecture exclusif, l’autorisation d’écriture est rétrogradée en FILE_SHARE_READ. Cette valeur est NULL si une vérification d’autorisation d’écriture n’est pas effectuée sur l’accès au partage.
Valeur de retour
La routine IoCheckShareAccessEx 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows 7 et versions ultérieures de Windows. |
| plateforme cible | Universel |
| d’en-tête | wdm.h |
| bibliothèque | Ntoskrnl.lib |