Fonction IoRemoveShareAccess (wdm.h)
La routine IoRemoveShareAccess supprime les informations d’accès et d’accès de partage pour un instance ouvert donné d’un objet fichier.
Syntaxe
void IoRemoveShareAccess(
[in] PFILE_OBJECT FileObject,
[in, out] PSHARE_ACCESS ShareAccess
);
Paramètres
[in] FileObject
Pointeur vers l’objet file, qui est généralement fermé par le thread actuel.
[in, out] ShareAccess
Pointeur vers la structure d’accès partagé qui décrit la façon dont l’objet de fichier ouvert est actuellement accessible.
Valeur de retour
None
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é passé à IoRemoveShareAccess au moyen d’un type de verrou, tel qu’un mutex ou un verrou de ressource, afin d’empêcher la corruption du nombre d’accès partagé.
Les appelants d’IoRemoveShareAccess doivent être en cours d’exécution sur IRQL = PASSIVE_LEVEL et dans le contexte du thread qui a demandé que l’objet FileObject soit fermé.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible à partir de Windows 2000. |
| Plateforme cible | Universal |
| 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) |