Fonction IoSetLinkShareAccess (wdm.h)

La routine IoSetLinkShareAccess définit les droits d’accès pour le partage de lien de l’objet de fichier spécifié.

Syntaxe

void IoSetLinkShareAccess(
  [in]                ACCESS_MASK        DesiredAccess,
  [in]                ULONG              DesiredShareAccess,
  [in, out]           PFILE_OBJECT       FileObject,
  [in, out]           PSHARE_ACCESS      ShareAccess,
  [in, out, optional] PLINK_SHARE_ACCESS LinkShareAccess,
  [in]                ULONG              IoShareAccessFlags
);

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, out, optional] LinkShareAccess

Pointeur vers la structure de données de partage d’accès (LINK_SHARE_ACCESS) de liaison commune associée à FileObject. Les pilotes doivent traiter cette structure comme opaque.

[in] IoShareAccessFlags

Masque de bits de ces indicateurs :

IO_SHARE_ACCESS_NO_WRITE_PERMISSION (0x80000000) spécifie que l’utilisateur n’a pas d’autorisation d’écriture pour le fichier. Cet indicateur est utilisé pour empêcher l’ouverture d’un fichier pour un accès en lecture exclusif lorsque l’utilisateur ne dispose pas des autorisations appropriées.

IO_CHECK_SHARE_ACCESS_UPDATE_SHARE_ACCESS (0x00000001) indique si la structure SHARE_ACCESS est mise à jour.

Valeur de retour

None

Configuration requise

Voir aussi

IoCheckLinkShareAccess

IoRemoveLinkShareAccess

IoUpdateLinkShareAccess