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

Voir aussi

IoCheckLinkShareAccess

IoSetLinkShareAccess

IoUpdateLinkShareAccess