Fonction IoRemoveLinkShareAccess (wdm.h)

La routine IoRemoveLinkShareAccess supprime les informations d’accès et d’accès au partage pour un instance ouvert donné 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 actif.

[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 de partage d’accès (LINK_SHARE_ACCESS) de liaison commune associée à FileObject. Les pilotes doivent traiter cette structure comme opaque.

Valeur de retour

None

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é passé à IoRemoveLinkShareAccess au moyen d’un type quelconque de verrou, tel qu’un mutex ou un verrou de ressource, afin d’empêcher l’altération du nombre d’accès partagés.

Les appelants d’IoRemoveLinkShareAccess doivent être en cours d’exécution à IRQL = PASSIVE_LEVEL et dans le contexte du thread qui a demandé la fermeture de FileObject .

Configuration requise

Voir aussi

IoCheckLinkShareAccess

IoSetLinkShareAccess

IoUpdateLinkShareAccess