Fonction IoUpdateShareAccess (wdm.h)
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) |