Fonction IoUpdateShareAccess (wdm.h)

  • Article

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

Syntaxe

void IoUpdateShareAccess(
  [in]      PFILE_OBJECT  FileObject,
  [in, out] PSHARE_ACCESS ShareAccess
);

Paramètres

[in] FileObject

Pointeur vers un objet de fichier référencé représentant le fichier ou l’objet d’appareil associé pour lequel mettre à jour l’accès au partage.

[in, out] ShareAccess

Pointeur vers la structure de SHARE_ACCESS commune associée à FileObject. Les pilotes doivent traiter cette structure comme opaque.

Valeur de retour

None

Remarques

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

Avant d’appeler IoUpdateShareAccess, l’appelant doit appeler avec succès IoCheckShareAccess avec update défini sur False. Un tel appel à IoCheckShareAccess 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 . IoUpdateShareAccess met à jour la structure SHARE_ACCESS associée à l’objet fichier.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible à partir de Windows 2000.
Plateforme cible Universal
En-tête wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Règles de conformité DDI HwStorPortProhibitedDDIs(storport),IrqlIoPassive5(wdm), PowerIrpDDis(wdm)

Voir aussi

IoCheckShareAccess

IoRemoveShareAccess

IoSetShareAccess