Fonction IoSetShareAccessEx (wdm.h)
La routine IoSetShareAccessEx définit les droits d’accès pour le partage de l’objet de fichier spécifié.
Syntaxe
void IoSetShareAccessEx(
[in] ACCESS_MASK DesiredAccess,
[in] ULONG DesiredShareAccess,
[in, out] PFILE_OBJECT FileObject,
[out] PSHARE_ACCESS ShareAccess,
[in, optional] PBOOLEAN WritePermission
);
Paramètres
[in] DesiredAccess
Spécifie une valeur ACCESS_MASK qui représente le type d’accès demandé pour l’objet de fichier. Consultez IoCreateFile pour obtenir la liste complète des indicateurs DesiredAccess définis par le système.
[in] DesiredShareAccess
Spécifie le type d’accès au partage à définir pour l’objet de fichier. Cette valeur peut être zéro ou n’importe quelle combinaison des indicateurs suivants :
FILE_SHARE_READ
FILE_SHARE_WRITE
FILE_SHARE_DELETE
[in, out] FileObject
Pointeur vers l’objet de fichier dont l’accès au partage est défini ou réinitialisé.
[out] ShareAccess
Pointeur vers la structure SHARE_ACCESS associée à FileObject. Les pilotes doivent traiter cette structure comme opaque.
[in, optional] WritePermission
Pointeur vers la valeur qui spécifie si l’objet de fichier dispose d’une autorisation d’écriture. Cette valeur est TRUE si le partage dispose d’une autorisation d’écriture ; sinon, il est FALSE. Si la valeur est FALSE 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.
Valeur de retour
Aucun
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 |