Partager via


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

Voir aussi

ACCESS_MASK

IoCreateFile