Fonction IoRemoveLinkShareAccess (wdm.h)
La routine IoRemoveLinkShareAccess supprime les informations d’accès et de liaison pour une instance ouverte donnée d’un objet de fichier.
Syntaxe
void IoRemoveLinkShareAccess(
[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
Cette routine est réciproque à IoUpdateLinkShareAccess.
IoRemoveLinkShareAccess n’est pas une opération atomique. Par conséquent, les pilotes appelant cette routine doivent protéger l’objet de fichier partagé transmis à IoRemoveLinkShareAccess 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é.
Les appelants de IoRemoveLinkShareAccess doivent s’exécuter à IRQL = PASSIVE_LEVEL et dans le contexte du thread qui a demandé que le FileObject soit fermé.
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 |