Fonction IoUpdateShareAccess (wdm.h)
La routine IoUpdateShareAccess met à jour l’accès au partage pour l’objet de fichier donné, généralement lorsque le fichier est ouvert.
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 SHARE_ACCESS courante associée au FileObject. Les pilotes doivent traiter cette structure comme opaque.
Valeur de retour
Aucun
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é transmis à IoUpdateShareAccess 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é.
Avant d’appeler IoUpdateShareAccess, l’appelant doit appeler correctement IoCheckShareAccess avec Mise à jour définie 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 ne met pas à jour la structure SHARE_ACCESS. IoUpdateShareAccess met réellement à jour la structure SHARE_ACCESS associée à l’objet de fichier.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows 2000. |
| plateforme cible | Universel |
| d’en-tête | wdm.h (include 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) |