Funzione IoUpdateShareAccess (wdm.h)
La routine IoUpdateShareAccess aggiorna l'accesso di condivisione per l'oggetto file specificato, in genere quando il file viene aperto.
Sintassi
void IoUpdateShareAccess(
[in] PFILE_OBJECT FileObject,
[in, out] PSHARE_ACCESS ShareAccess
);
Parametri
[in] FileObject
Puntatore a un oggetto file a cui si fa riferimento che rappresenta il file o l'oggetto dispositivo associato per cui aggiornare l'accesso alla condivisione.
[in, out] ShareAccess
Puntatore alla struttura di SHARE_ACCESS comune associata a FileObject. I driver devono trattare questa struttura come opaca.
Valore restituito
nessuno
Osservazioni
IoUpdateShareAccess non è un'operazione atomica. Pertanto, i driver che chiamano questa routine devono proteggere l'oggetto file condiviso passato a IoUpdateShareAccess tramite un tipo di blocco, ad esempio un mutex o un blocco di risorse, per impedire il danneggiamento dei conteggi di accesso condiviso.
Prima di chiamare IoUpdateShareAccess, il chiamante deve chiamare correttamente IoCheckShareAccess con Update impostato su False. Tale chiamata a IoCheckShareAccess determina se l'accesso condiviso richiesto è compatibile con il modo in cui l'oggetto file è attualmente accessibile da altre finestre, ma non aggiorna la struttura SHARE_ACCESS . IoUpdateShareAccess aggiorna effettivamente la struttura SHARE_ACCESS associata all'oggetto file.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile a partire da Windows 2000. |
| Piattaforma di destinazione | Universale |
| Intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| Regole di conformità DDI | HwStorPortProhibitedDDDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm) |