Partager via


Fonction IoUpdateLinkShareAccess (wdm.h)

La routine IoUpdateLinkShareAccess met à jour l’accès au partage pour l’objet de fichier donné, généralement lorsque le fichier est ouvert.

Syntaxe

void IoUpdateLinkShareAccess(
  [in]                PFILE_OBJECT       FileObject,
  [in, out]           PSHARE_ACCESS      ShareAccess,
  [in, out, optional] PLINK_SHARE_ACCESS LinkShareAccess
);

Paramètres

[in] FileObject

Pointeur vers l’objet de fichier, qui est généralement fermé par le thread actuel.

[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 d’accès au partage de liens commun (LINK_SHARE_ACCESS) associée à FileObject. Les pilotes doivent traiter cette structure comme opaque.

Valeur de retour

Aucun

Remarques

IoUpdateLinkShareAccess n’est pas une opération atomique. Par conséquent, les pilotes appelant cette routine doivent protéger l’objet de fichier partagé transmis à IoUpdateLinkShareAccess par le biais d’un type de verrou, tel qu’un mutex ou un verrou de ressource, afin d’empêcher l’altération du nombre d’accès partagé.

Avant d’appeler IoUpdateLinkShareAccess, l’appelant doit appeler correctement IoCheckLinkShareAccess avec Mise à jour définie sur False. Un tel appel à IoCheckLinkShareAccess détermine si l’accès partagé demandé est compatible avec la façon dont l’objet de fichier est actuellement accessible par d’autres ouvertures, mais ne met pas à jour la structure SHARE_ACCESS. IoUpdateLinkShareAccess met réellement à jour la structure de SHARE_ACCESS associée à l’objet de fichier.

Exigences

Exigence Valeur
client minimum pris en charge Windows 10, version 1709
serveur minimum pris en charge Windows Server 2016
plateforme cible Universel
d’en-tête wdm.h
bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

Voir aussi

IoCheckLinkShareAccess

IoRemoveLinkShareAccess

IoSetLinkShareAccess