Fonction IoRemoveShareAccess (wdm.h)
La routine IoRemoveShareAccess supprime les informations d’accès et de partage pour une instance ouverte donnée d’un objet de fichier.
Syntaxe
void IoRemoveShareAccess(
[in] PFILE_OBJECT FileObject,
[in, out] PSHARE_ACCESS ShareAccess
);
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 d’accès au partage qui décrit la façon dont l’objet de fichier ouvert est actuellement accessible.
Valeur de retour
Aucun
Remarques
Cette routine est réciproque à IoUpdateShareAccess.
IoRemoveShareAccess n’est pas une opération atomique. Par conséquent, les pilotes appelant cette routine doivent protéger l’objet de fichier partagé transmis à IoRemoveShareAccess 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 IoRemoveShareAccess 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 | Disponible à partir de Windows 2000. |
| plateforme cible | Universel |
| d’en-tête | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL (voir la section Remarques) |
| règles de conformité DDI | HwStorPortProhibitedDDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm) |