Fonction IoUpdateLinkShareAccess (wdm.h)

  • Article

La routine IoUpdateLinkShareAccess met à jour l’accès au partage pour l’objet de fichier donné, généralement lors de l’ouverture du fichier.

Syntaxe

void IoUpdateLinkShareAccess(
  [in]                PFILE_OBJECT       FileObject,
  [in, out]           PSHARE_ACCESS      ShareAccess,
  [in, out, optional] PLINK_SHARE_ACCESS LinkShareAccess
);

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

Valeur de retour

None

Remarques

IoUpdateLinkShareAccess n’est pas une opération atomique. Par conséquent, les pilotes appelant cette routine doivent protéger l’objet de fichier partagé passé à IoUpdateLinkShareAccess 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é.

Avant d’appeler IoUpdateLinkShareAccess, l’appelant doit appeler avec succès IoCheckLinkShareAccess avec Update défini sur False. Un tel appel à IoCheckLinkShareAccess détermine si l’accès partagé demandé est compatible avec la façon dont l’objet de fichier est actuellement accessible par d’autres ouvertures, mais il ne met pas à jour la structure SHARE_ACCESS . IoUpdateLinkShareAccess met en fait à jour la structure SHARE_ACCESS associée à l’objet file.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10, version 1709
Serveur minimal pris en charge Windows Server 2016
Plateforme cible Universal
En-tête wdm.h
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

Voir aussi

IoCheckLinkShareAccess

IoRemoveLinkShareAccess

IoSetLinkShareAccess