Funzione IoUpdateShareAccess (wdm.h)
Il IoUpdateShareAccess routine aggiorna l'accesso alla 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 di riferimento che rappresenta il file o l'oggetto dispositivo associato per il quale aggiornare l'accesso alla condivisione.
[in, out] ShareAccess
Puntatore alla struttura di SHARE_ACCESS comune associata al FileObject. I driver devono considerare 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 evitare il danneggiamento dei conteggi di accesso condiviso.
Prima di chiamare IoUpdateShareAccess, il chiamante deve chiamare correttamente IoCheckShareAccess con Update impostato su False. Una chiamata di questo tipo a IoCheckShareAccess determina se l'accesso condiviso richiesto è compatibile con il modo in cui l'oggetto file è attualmente accessibile da altri elementi aperti, ma non aggiorna la struttura SHARE_ACCESS. IoUpdateShareAccess aggiorna effettivamente la struttura SHARE_ACCESS associata all'oggetto file.
Fabbisogno
| 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 | HwStorPortProhibitedDDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm) |