Fonction IoRemoveShareAccess (wdm.h)

  • Article

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)

Voir aussi

IoCheckShareAccess

IoSetShareAccess

IoUpdateShareAccess