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 |