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 case activée 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 demande ouverte actuelle. La valeur de ce paramètre est généralement identique au paramètre ShareAccess qui est passé au système de fichiers ou au pilote de niveau supérieur par le gestionnaire d’E/S lorsque la demande 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 fichier pour lequel case activée accès pour la demande 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 le status d’accès au partage pour FileObject. Une valeur booléenne TRUE signifie que cette routine met à jour les informations d’accès au partage pour l’objet 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 d’obtenir un accès en lecture exclusif, l’autorisation d’écriture est rétrogradée en FILE_SHARE_READ. Cette valeur est NULL si une autorisation d’écriture case activée n’est pas effectuée sur l’accès au partage.
Valeur retournée
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é.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Windows 7 et versions ultérieures de Windows. |
| Plateforme cible | Universal |
| En-tête | wdm.h |
| Bibliothèque | Ntoskrnl.lib |